ListEdgeAgentConfigurations - Amazon Kinesis Video Streams

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.