ListTagsForStream - Amazon Kinesis Video Streams
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

ListTagsForStream

返回與指定流相關聯的標籤列表。

在請求中，您必須指定StreamName或StreamARN。

請求語法

POST /listTagsForStream HTTP/1.1
Content-type: application/json

{
   "NextToken": "string",
   "StreamARN": "string",
   "StreamName": "string"
}

URI 請求參數

請求不會使用任何 URI 參數。

請求主體

請求接受採用 JSON 格式的下列資料。

NextToken

如果您指定此參數且ListTagsForStream呼叫的結果會被截斷，則回應會包含一個 Token，您可以在下一個要求中使用這個 Token 來擷取下一批標籤。

類型：字串

長度限制：長度下限為 0。長度上限為 512。

模式：[a-zA-Z0-9+/=]*

必要：否

StreamARN

您要列出標籤的流的 Amazon 資源名稱（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_.-]+

必要：否

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tags": { 
      "string" : "string" 
   }
}

回應元素

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

NextToken

如果您指定此參數且ListTags呼叫的結果會被截斷，則回應會包含一個 Token，您可以在下一個要求中使用它來擷取下一組標籤。

類型：字串

長度限制：長度下限為 0。長度上限為 512。

模式：[a-zA-Z0-9+/=]*

Tags

與指定流相關聯的標籤鍵和值的映射。

類型：字串到字串映射

地圖項目：最多 50 個項目。

索引鍵長度限制：長度下限為 1。長度上限為 128。

金鑰模式：^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

值長度限制：最小長度為 0。長度上限為 256。

值模式：[\p{L}\p{Z}\p{N}_.:/=+\-@]*

錯誤

如需所有動作常見錯誤的資訊，請參閱常見錯誤。

ClientLimitExceededException

Kinesis Video Streams 已限制要求，因為您已經超過允許的用戶端呼叫限制。稍後再嘗試撥打電話。

HTTP 狀態碼：400

InvalidArgumentException

此輸入參數的值無效。

HTTP 狀態碼：400

InvalidResourceFormatException

的格式StreamARN無效。

HTTP 狀態碼：400

NotAuthorizedException

呼叫者沒有執行此操作的授權。

狀態碼：4

ResourceNotFoundException

Amazon Kinesis Video Streams 找不到您指定的串流。

HTTP 狀態碼：404

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：