기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ListEdgeAgentConfigurations
지정된 Edge Agent와 관련된 에지 구성의 배열을 반환합니다.
요청 시 에지 에이전트를 지정해야 HubDeviceArn
합니다.
참고
이 API는 AWS 아프리카 (케이프타운) 지역인 af-south-1에서는 사용할 수 없습니다.
Request Syntax
POST /listEdgeAgentConfigurations HTTP/1.1
Content-type: application/json
{
"HubDeviceArn": "string
",
"MaxResults": number
,
"NextToken": "string
"
}
URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- HubDeviceArn
-
엣지 에이전트의 “사물 인터넷 (IoT) 사물” Arn.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.
패턴:
arn:[a-z\d-]+:iot:[a-z0-9-]+:[0-9]+:thing/[a-zA-Z0-9_.-]+
필수 사항 여부: Yes
- MaxResults
-
응답으로 반환되는 최대 에지 구성 수입니다. 기본값은 5입니다.
타입: 정수
유효한 범위: 최소값 1. 최대값은 10입니다.
필수 여부: 아니요
- NextToken
-
이 매개 변수를 지정하면
ListEdgeAgentConfigurations
작업 결과가 잘리면 호출은NextToken
응답에서 를 반환합니다. 다른 엣지 구성을 일괄 처리하려면 다음 요청 시 이 토큰을 제공하십시오.타입: 문자열
길이 제한: 최소 길이는 0. 최대 길이는 512입니다.
패턴:
[a-zA-Z0-9+/=]*
필수 여부: 아니요
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"EdgeConfigs": [
{
"CreationTime": number,
"EdgeConfig": {
"DeletionConfig": {
"DeleteAfterUpload": boolean,
"EdgeRetentionInHours": number,
"LocalSizeConfig": {
"MaxLocalMediaSizeInMB": number,
"StrategyOnFullSize": "string"
}
},
"HubDeviceArn": "string",
"RecorderConfig": {
"MediaSourceConfig": {
"MediaUriSecretArn": "string",
"MediaUriType": "string"
},
"ScheduleConfig": {
"DurationInSeconds": number,
"ScheduleExpression": "string"
}
},
"UploaderConfig": {
"ScheduleConfig": {
"DurationInSeconds": number,
"ScheduleExpression": "string"
}
}
},
"FailedStatusDetails": "string",
"LastUpdatedTime": number,
"StreamARN": "string",
"StreamName": "string",
"SyncStatus": "string"
}
],
"NextToken": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- EdgeConfigs
-
단일 스트림의 엣지 구성에 대한 설명.
유형: ListEdgeAgentConfigurationsEdgeConfig객체 어레이
- NextToken
-
응답이 잘린 경우 호출 시 지정된 토큰과 함께 이 요소가 반환됩니다. 다음 엣지 구성 배치를 가져오려면 다음 요청 시 이 토큰을 사용하세요.
타입: 문자열
길이 제한: 최소 길이는 0. 최대 길이는 512입니다.
패턴:
[a-zA-Z0-9+/=]*
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- ClientLimitExceededException
-
허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams가 요청 병목 현상을 일으켰습니다. 나중에 전화를 걸어 보세요.
HTTP 상태 코드: 400
- InvalidArgumentException
-
이 입력 매개변수의 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- NotAuthorizedException
-
호출자는 이 작업을 수행할 권한이 없습니다.
HTTP 상태 코드: 401
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.