최대 가용량 API 작업 work

이 페이지에서: Adobe Journey Optimizer 최대 가용량 API를 사용하여 외부 시스템에 대한 호출을 제한하는 끝점 최대 가용량 구성을 만들고, 구성하고, 배포하고, 모니터링하는 방법을 알아봅니다.

최대 가용량 API를 사용하면 최대 가용량 구성을 만들고, 구성하고, 모니터링할 수 있습니다.

이 섹션에서는 API 작업 방법에 대한 전역 정보를 제공합니다. 자세한 API 설명은 Adobe Journey Optimizer API 설명서에서 확인할 수 있습니다.

최대 가용량 API 설명 및 Postman 컬렉션 description

아래 표에는 최대 가용량 API에 사용할 수 있는 명령이 나열되어 있습니다. 요청 샘플, 매개 변수 및 응답 형식을 포함한 자세한 정보는 Adobe Journey Optimizer API 설명서에서 확인할 수 있습니다.

구성을 만들거나 업데이트할 때 페이로드의 구문 및 무결성을 보장하기 위해 자동으로 검사가 수행됩니다.
일부 문제가 발생하면 작업을 수행할 때 경고 또는 오류가 반환되어 구성을 수정하는 데 도움이 됩니다.

또한 테스트 구성에 도움이 되도록 여기에서 Postman 컬렉션을 사용할 수 있습니다.

이 컬렉션은 Postman 콘솔의 통합 > 사용해 보기 > Postman 다운로드​를 통해 생성된 Adobe I/O 변수 컬렉션을 공유하도록 설정되었습니다. 이 컬렉션은 선택한 통합 값으로 Postman 환경 파일을 생성합니다.

다운로드하여 Postman에 업로드한 다음에는 {JO_HOST}, {BASE_PATH}, {SANDBOX_NAME} 세 가지 변수를 추가해야 합니다.

끝점 구성

다음은 끝점 구성의 기본 구조입니다.

{
    "url": "<endpoint URL>",  //wildcards are allowed in the endpoint URL
    "methods": [ "<HTTP method such as GET, POST, >, ...],
    "services": {
        "<service name>": { . //must be "action" or "dataSource"
            "maxHttpConnections": <max connections count to the endpoint (optional)>
            "rating": {
                "maxCallsCount": <max calls to be performed in the period defined by period/timeUnit>,
                "periodInMs": <integer value greater than 0>
            }
        },
        ...
    }
}

예:

{
  "url": "https://api.example.org/data/2.5/*",
  "methods": [
    "GET"
  ],
  "services": {
    "dataSource": {
      "rating": {
        "maxCallsCount": 500,
        "periodInMs": 1000
      }
    }
  }
}

경고 및 오류

canDeploy 메서드가 호출되면 이 프로세스는 구성을 확인하고 다음 중 하나의 고유 ID로 확인된 유효성 검사 상태를 반환합니다.

"ok" or "error"

잠재적 오류는 다음과 같습니다.

잠재적인 경고는 다음과 같습니다.

ERR_ENDPOINTCONFIG_106: 최대 구성: 최대 HTTP 연결이 정의되지 않음: 기본적으로 제한 없음

사용 사례

이 섹션에는 Journey Optimizer에서 최대 가용량 구성을 관리하기 위한 주요 사용 사례와 사용 사례를 구현하는 데 필요한 관련 API 명령이 나열되어 있습니다.

각 API 명령에 대한 자세한 내용은 API 설명 및 Postman 컬렉션에서 확인할 수 있습니다.