기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
SearchAssociatedTranscripts
지정된 기준을 충족하는 연결된 기록을 검색합니다.
요청 구문
POST /bots/botId/botversions/botVersion/botlocales/localeId/botrecommendations/botRecommendationId/associatedtranscripts HTTP/1.1
Content-type: application/json
{
"filters": [
{
"name": "string",
"values": [ "string" ]
}
],
"maxResults": number,
"nextIndex": number,
"searchOrder": "string"
}URI 요청 파라미터
요청은 다음의 URI 파라미터를 사용합니다.
- botId
-
검색 중인 기록과 연결된 봇의 고유 식별자입니다.
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$: 필수 예
- botRecommendationId
-
검색할 기록과 연결된 봇 추천의 고유 식별자입니다.
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$: 필수 예
- botVersion
-
검색 중인 기록을 포함하는 봇의 버전입니다.
길이 제약 조건: 최소 길이는 1이고, 최대 길이는 5입니다.
Pattern:
^(DRAFT|[0-9]+)$: 필수 예
- localeId
-
검색할 성적 증명서의 언어 및 로케일의 식별자입니다. 문자열은 지원되는 로케일 중 하나와 일치해야 합니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어
: 필수 예
요청 본문
요청은 JSON 형식의 다음 데이터를 받습니다.
- filters
-
필터 객체 목록입니다.
Type: 배열AssociatedTranscriptFilter사물
배열 멤버: 고정 항목 수는 1개입니다.
: 필수 예
- maxResults
-
결과의 각 페이지에서 반환할 최대 봇 추천 수입니다. 최대 페이지 크기보다 결과가 적으면 실제 결과 수만 반환됩니다.
Type: 정수
유효한 범위: 최소값 1. 최대값 1000입니다.
: 필수 아니요
- nextIndex
-
SearchAssociatedTranscriptsRequest 작업의 응답에 maxResults 매개 변수에 지정된 것보다 많은 결과가 포함된 경우 응답에서 인덱스가 반환됩니다. 에 대한 NextIndex 파라미터에서 이 인덱스를 사용하여 다음 결과 페이지를 반환합니다.
Type: 정수
유효한 범위: 최소값 0. 최대값은 10000000입니다.
: 필수 아니요
- searchOrder
-
검색결과 정렬 방법. 유효한 값은 오름차순 또는 내림차순입니다. 기본값은 내림차순입니다.
Type: 문자열
유효한 값:
Ascending | Descending: 필수 아니요
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"associatedTranscripts": [
{
"transcript": "string"
}
],
"botId": "string",
"botRecommendationId": "string",
"botVersion": "string",
"localeId": "string",
"nextIndex": number,
"totalResults": number
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- associatedTranscripts
-
지정한 조건을 충족하는 연관된 대본이 포함된 객체입니다.
Type: 배열AssociatedTranscript사물
- botId
-
검색 중인 기록과 연결된 봇의 고유 식별자입니다.
Type: 문자열
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$ - botRecommendationId
-
검색할 기록과 연결된 봇 추천의 고유 식별자입니다.
Type: 문자열
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$ - botVersion
-
검색 중인 기록을 포함하는 봇의 버전입니다.
Type: 문자열
길이 제약 조건: 최소 길이는 1이고, 최대 길이는 5입니다.
Pattern:
^(DRAFT|[0-9]+)$ - localeId
-
검색할 성적 증명서의 언어 및 로케일의 식별자입니다. 문자열은 지원되는 로케일 중 하나와 일치해야 합니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어
Type: 문자열
- nextIndex
-
SearchAssociatedTranscript 작업에 대한 응답으로 반환할 결과가 더 있는지 여부를 나타내는 인덱스입니다. NextIndex 필드가 있는 경우 내용을 검색어소시에이트트랜스크립트요청 작업의 NextIndex 매개 변수로 전송하여 다음 결과 페이지를 가져옵니다.
Type: 정수
유효한 범위: 최소값 0. 최대값은 10000000입니다.
- totalResults
-
검색에서 반환한 총 기록 수입니다.
Type: 정수
유효한 범위: 최소값 1. 최대값 1000입니다.
오류
모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.
- InternalServerException
-
서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 500
- ResourceNotFoundException
-
사용자가 존재하지 않는 리소스를 설명해 달라고 요청했습니다. 요청하는 리소스를 확인하고 다시 시도하십시오.
HTTP 상태 코드: 404
- ServiceQuotaExceededException
-
봇에 대한 할당량에 도달했습니다.
HTTP 상태 코드: 402
- ThrottlingException
-
요청량이 너무 높습니다. 요청 횟수를 줄입니다.
HTTP 상태 코드: 429
- ValidationException
-
요청의 입력 파라미터 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
