장치 세부 정보 요청

Automation Anywhere Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

PDF 다운로드

장치 세부 정보 요청

이 API를 사용하여 bot 배포에 사용할 수 있는 장치 목록을 검색합니다.

전제 조건

역할 및 라이선스: 무인 봇 러너 라이선스가 있는 사용자로 인증해야 합니다.

URL:

http://<your_control_room_url>/v2/devices/list

메소드: POST

지원되는 필터링 가능한 매개변수:

id

장치에 대한 숫자 식별자입니다.

필드: id
유형: 정수

{
  "filter": {
    "operator": "eq",
    "value": "7",
    "field": "id"
  }
}

hostName

등록된 장치의 이름입니다.

필드: hostName
유형: 문자열

{
  "filter": {
    "operator": "substring",
    "value": "AA",
    "field": "hostName"
  }
}

userId

등록된 장치와 연결된 사용자에 대한 고유한 숫자 식별자입니다.

필드: userId
유형: 길이가 김

{
  "filter": {
    "operator": "eq",
    "value": "13",
    "field": "userId"
  }
}

상태

장치의 연결 상태입니다.

필드: 상태
유형: 문자열

{
  "filter": {
     "operator": "eq",
     "value": "CONNECTED",
     "field": "status"
      }
}

이 태스크는 hostname 매개변수에 특정 문자열이 있는 모든 기기의 목록과 기기의 특정 상태를 요청합니다. 응답에 있는 목록을 사용하여 연결된 기기 및 bots을 실행할 수 있는 기기를 식별합니다.

프로시저

POST 메소드를 이용하여 인증 JSON 웹 토큰을 생성합니다. 요청 헤더에 생성된 인증 토큰을 추가합니다.
인증 API
POST 메소드를 선택합니다.

API에 대한 URL을 입력합니다.

https://<your_control_room_url>/v2/devices/list

요청 본문에서 필터링, 정렬 및 페이지 매김 규칙을 추가하여 배포하려는 기기 목록을 검색합니다.

예를 들어, 이 요청 본문은 연산자로 "and"를 사용하고, 필요한 결과를 필터링하기 위해 필드로 기기 "status" 및 "hostname"을 사용합니다. 결과는 "status"에 따라 "내림차순"으로 정렬됩니다.

{
  "sort": [
    {
      "field": "status",
      "direction": "desc"
    }
  ],
  "filter": {
    "operator": "and",
    "operands": [
      {
        "operator": "eq",
        "value": "CONNECTED",
        "field": "status"
      },
      {
        "operator": "substring",
        "value": "win",
        "field": "hostName"
      }
    ]
  },
  "fields": [
    
  ],
  "page": {
    "offset": 0,
    "total": 71,
    "totalFilter": 18,
    "length": 100
  }
}

요청을 전송합니다.

REST 클라이언트에서 SEND를 클릭합니다.
스웨거 인터페이스에서 실행을 클릭합니다.

응답 본문:

이 응답은 "연결됨" 상태에 있고 요청된 필터 기준에 따라 hostName이 "win"으로 시작하는 두 기기의 세부 정보를 반환합니다.

{
  "page": {
    "offset": 0,
    "total": 71,
    "totalFilter": 7
  },
  "list": [{
    "id": "163",
    "type": "ATTENDED_BOT_RUNNER",
    "hostName": "winwlm-2",
    "userId": "",
    "userName": "",
    "status": "CONNECTED",
    "poolName": "",
    "fullyQualifiedHostName": "-",
    "updatedBy": "b2",
    "updatedOn": "2020-07-07T08:24:56.091061Z",
    "botAgentVersion": "12.1"
  }, {
    "id": "162",
    "type": "ATTENDED_BOT_RUNNER",
    "hostName": "winwlm-1",
    "userId": "",
    "userName": "",
    "status": "CONNECTED",
    "poolName": "",
    "fullyQualifiedHostName": "-",
    "updatedBy": "b1",
    "updatedOn": "2020-07-07T08:24:55.982047Z",
    "botAgentVersion": "12.1"
  }
}

다음 단계

응답에서 받은 기기 ID를 사용하여 Bot Runners에서 bots을 배포할 수 있습니다.

피드백을 보내주십시오