API Task 온디맨드 엔드포인트

엔드포인트로 API Tasks를 즉시 호출하십시오. 그러면 온디맨드 요청과 함께 배포 API를 사용하여 API Tasks가 동적으로 시작되고 실행됩니다. 이 접근 방식은 기존의 정적 배포에 비해 워크플로를 간소화하고 리소스 효율성을 개선합니다.

주: API Tasks는 대화형 양식을 지원하지 않습니다.

핵심 이점

  • 프로그래밍 방식 배포: 원하는 API 클라이언트를 사용하여 온디맨드 방식으로 어디서나 API Task를 배포하십시오.
  • 프로세싱:
    • 자동화는 필요할 때만 활성화되어 최적의 리소스 활용도를 보장합니다. 즉, 클라우드에 지속적으로 배포되어 리소스를 예약하지 않습니다. 대신 각 요청이 있을 때마다 로드되고 실행됩니다.
    • 사용량이 많은 기간에는 자동화가 대기열에 배치되어 기기를 사용할 수 있게 되는 즉시 실행되므로 부하가 많은 상황에서도 원활한 운영을 보장합니다. 활동 페이지에서 자동화의 진행 상황을 확인할 수 있습니다.
    • 프리미엄 라이선스는 자동화를 확장하고 API Task의 여러 인스턴스를 실행할 수 있는 더 큰 클라우드 리소스 풀에 액세스하여 동시성을 높이고 더 많은 API Task 요청을 동시에 처리할 수 있도록 도와줍니다.
  • 이상적인 사용 사례:
    • 일괄 처리 작업(예: 판매 데이터 분석, 보고서 생성)
    • 예약된 태스크
    • 즉각적인 대응이 중요하지 않은 상황
주: 프로세스 내에서 온디맨드 API Task 배포를 활성화하려면 관리 > 설정 > Bot 에이전트 대량 설치 > 새 키 생성에서 등록 키를 생성하고 변경 사항 저장을 클릭하십시오.

인증

배포 API와 상호 작용하는 데 필요한 인증 자격증명을 획득합니다. 여기에는 일반적으로 액세스 토큰 또는 API 키가 포함됩니다. 다음 샘플은 클라우드 장치에 API Task 온디맨드를 배포하는 예제입니다. 또한 배포할 때 봇에 변수를 전달할 수도 있습니다.

POST https://{{ControlRoomURL}}/v4/automations/deploy

Header: X-Authorization: <<authentication token>> or Authorization: Bearer <<b
earer token>>

모든 API 호출에는 인증 API의 인증 토큰(JSON 웹 토큰 생성) 또는 OAuth 서비스의 전달자 토큰이 포함되어야 합니다. 하나의 API에서 둘 모두를 사용할 수 없습니다.

온디맨드 요청 작성

요청:
{
  "botId": 121,
  "automationName": "SAMPLE_APITASK",
  "description": "My first API Task deploy using api",
  "botLabel": "string",
  "executionType": "RUN_NOW",
  "automationPriority": "PRIORITY_MEDIUM",
  "headlessRequest": {
    "numberOfExecutions": 1,
    "queueOnSlotsExhaustion": false,
    "sharedRunAsUserId": 12
  },
  "botInput": {
    "inputVar": {
      "type": "STRING",
      "string": "PassingString"
    }
  }
}
주:

자동화 배포 요청은 입력 필드 없이 만들 수 있습니다. 입력을 지정하는 경우 API Task에서 이러한 매핑된 값을 성공적으로 수신하고, 해당 자동화에 해당하는 변수를 입력으로 표시해야 합니다. 또한 API Task의 변수 이름은 요청 본문에 매핑되는 값과 일치해야 합니다.

요청 매개변수
매개변수 유형 필수 설명
botId 정수 예 배포할 자동화의 ID를 입력합니다. 자동화를 편집기에서 열 때 주소 표시줄에 ID가 표시됩니다.
automationName 문자열 아니오 자동화를 만들 때 사용한 이름을 입력합니다.
설명 문자열 아니오 자동화를 생성할 때 사용한 설명을 입력합니다.
botLabel 문자열 아니오 자동화에 체크인할 때 적용한 라벨을 입력합니다. 프로덕션 또는 N/A를 입력할 수 있습니다.
executionType 문자열 아니오 봇과 관련된 실행 유형을 입력합니다. 다음 실행 유형 중 하나를 입력할 수 있습니다.
  • RUN_NOW
  • RUN_WITH_QUEUE
  • RUN_WITH_EVENT_TRIGGERS
automationPriority 문자열 아니오 자동화 실행의 우선 순위를 입력합니다. 다음 우선순위 중 하나를 입력할 수 있습니다.
  • PRIORITY_MEDIUM
  • PRIORITY_HIGH
  • PRIORITY_LOW
기본 우선순위는 PRIORITY_MEDIUM으로 설정됩니다.
headlessRequest 객체.
numberOfExecutions 정수 아니오 주어진 온디맨드(헤드리스) 요청에 대해 실행할 실행 횟수를 입력합니다.
queueOnSlotsExhaustion 부울 아니오 배포를 대기열에 추가해야 할지 지정하도록 True 또는 False를 입력합니다.
sharedRunAsUserId 정수 아니오 apitaskrunner 사용자의 사용자 ID를 입력하여 API Tasks에 대한 RunAsUser 컨텍스트를 설정합니다.

사용자 세부 정보를 사용자 편집 페이지에서 편집할 때 주소 표시줄에 사용자 ID가 표시됩니다.

Apitaskrunner에 대한 자세한 내용은 API Task에 대한 실행 주체 사용자(apitaskrunner) 항목을 참조하십시오.
주: RunAsUser에는 Bot Runner 라이선스가 필요하지 않습니다.
botInput 객체
type 모두 아니오 입력 변수의 유형을 입력합니다.

다음과 같은 변수 유형 중 하나를 입력할 수 있습니다. STRING, NUMBER, BOOLEAN, FILE, ITERATOR, LIST, DICTIONARY, TABLE, VARIABLE, CONDITIONAL, WINDOW, TASKBOT, DATETIME, UIOBJECT, RECORD, EXCEPTION, CREDENTIAL, COORDINATE, IMAGE, REGION, PROPERTIES, TRIGGER, CONDITIONALGROUP, FORM, FORMELEMENT, HOTKEY, WORKITEM.
문자열 문자열 아니오 STRING 변수에 입력값으로 사용해야 하는 문자열을 입력합니다.
응답 
{
  "deploymentId": "320a2149-aa44-41ab-af9b-f9343ae2581b",
  "automationName": "SAMPLE_APITASK"
}
응답 매개변수
매개변수 유형 설명
deploymentId 문자열 봇 배포 중에 생성된 배포 ID입니다.
automationName 문자열 배포된 자동화의 이름입니다. 요청에 자동화 이름을 포함하지 않으면 배포된 자동화에 임의의 이름이 지정됩니다.
모든 Control Room 인스턴스에 포함된 Swagger 인터페이스에서 이 엔드포인트를 테스트할 수 있습니다.
팁: Control Room 인스턴스로 이동한 후 URL 끝에 /swagger/를 추가하여 Swagger에 액세스합니다.https://{{ControlRoomURL}}/swagger/

Control Room에서 활동 페이지를 확인하여 대기 중 >> 진행 중 완료에서 온디맨드(헤드리스) 실행 진행 상황을 추적할 수 있습니다.

API-태스크-활동 페이지

배포 API에 대한 자세한 내용은 Bot 배포 API(V4) 항목을 참조하십시오.