本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
DescribeEdgeConfiguration
描述使用 StartEdgeConfigurationUpdate
API 設定的串流邊緣設定,以及 Edge 代理程式的記錄器和上傳程式工作的最新狀態。使用此 API 取得組態的狀態,以判斷組態是否與 Edge 代理程式同步。使用此 API 來評估 Edge 代理程式的健全狀況。
注意
AWS 非洲 (開普敦) 地區 af-south-1 不提供此 API。
請求語法
POST /describeEdgeConfiguration HTTP/1.1
Content-type: application/json
{
"StreamARN": "string
",
"StreamName": "string
"
}
URI 請求參數
請求不會使用任何 URI 參數。
請求主體
請求接受採用 JSON 格式的下列資料。
- StreamARN
-
串流的 Amazon Resource Name (ARN)。指定
StreamName
或StreamARN
。類型:字串
長度限制:長度下限為 1。長度上限為 1024。
模式:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+
必要:否
- StreamName
-
要更新其邊緣配置的流的名稱。指定
StreamName
或StreamARN
。類型:字串
長度限制:長度下限為 1。長度上限為 256。
模式:
[a-zA-Z0-9_.-]+
必要:否
回應語法
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"EdgeAgentStatus": {
"LastRecorderStatus": {
"JobStatusDetails": "string",
"LastCollectedTime": number,
"LastUpdatedTime": number,
"RecorderStatus": "string"
},
"LastUploaderStatus": {
"JobStatusDetails": "string",
"LastCollectedTime": number,
"LastUpdatedTime": number,
"UploaderStatus": "string"
}
},
"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"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- CreationTime
-
第一次建立串流邊緣設定的時間戳記。
類型:Timestamp
- EdgeAgentStatus
-
包含 Edge 代理程式的記錄器和上傳工作之最新狀態詳細資料的物件。使用此資訊可判斷 Edge 代理程式目前的健全狀況。
類型:EdgeAgentStatus 物件
- EdgeConfig
-
將用來與邊緣代理程式 IoT Greengrass 元件同步處理之串流邊緣設定的說明。Edge 代理程式元件將在您的內部部署的 IoT 中樞裝置設定上執行。
類型:EdgeConfig 物件
- FailedStatusDetails
-
產生失敗狀態的描述。
類型:字串
- LastUpdatedTime
-
上次更新串流邊緣設定的時間戳記。
類型:Timestamp
- StreamARN
-
串流的 Amazon Resource Name (ARN)。
類型:字串
長度限制:長度下限為 1。長度上限為 1024。
模式:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+
- StreamName
-
邊緣組態已更新來源的資料流名稱。
類型:字串
長度限制:長度下限為 1。長度上限為 256。
模式:
[a-zA-Z0-9_.-]+
- SyncStatus
-
邊緣組態更新的最新狀態。
類型:字串
有效值:
SYNCING | ACKNOWLEDGED | IN_SYNC | SYNC_FAILED | DELETING | DELETE_FAILED | DELETING_ACKNOWLEDGED
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- AccessDeniedException
-
您沒有執行此作業所需的權限。
狀態碼:4
- ClientLimitExceededException
-
Kinesis Video Streams 已限制要求,因為您已經超過允許的用戶端呼叫限制。稍後再嘗試撥打電話。
HTTP 狀態碼:400
- InvalidArgumentException
-
此輸入參數的值無效。
HTTP 狀態碼:400
- ResourceNotFoundException
-
Amazon Kinesis Video Streams 找不到您指定的串流。
HTTP 狀態碼:404
- StreamEdgeConfigurationNotFoundException
-
當 Amazon Kinesis 視訊串流找不到您指定的串流邊緣組態時,會呈現例外狀況。
HTTP 狀態碼:404
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: