ListTags - AWS Backup

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

ListTags

傳回指定給資源的標籤,例如目標復原點、備份計劃或備份儲存庫。

請求語法

GET /tags/resourceArn/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1

URI請求參數

請求使用下列URI參數。

MaxResults

所要傳回的項目數量上限。

有效範圍:最小值為 1。最大值為 1000。

NextToken

傳回項目之部分列表後的下一個項目。例如,如果請求傳回 MaxResults 個數量的項目,則 NextToken 允許您從下一個字符指向的位置開始傳回列表中的更多項目。

resourceArn

可唯一識別資源的 Amazon 資源名稱 (ARN)。的格式取ARN決於資源的類型。ListTags 的有效目標為復原點、備份計劃和備份保存庫。

必要:是

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Tags": { "string" : "string" } }

回應元素

如果動作成功,服務會傳回 HTTP 200 回應。

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

NextToken

傳回項目之部分列表後的下一個項目。例如,如果請求傳回 MaxResults 個數量的項目,則 NextToken 允許您從下一個字符指向的位置開始傳回列表中的更多項目。

類型:字串

Tags

有關標籤的信息。

類型:字串到字串映射

錯誤

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

InvalidParameterValueException

表示參數的值出現問題。例如,值超出範圍。

HTTP狀態碼:

MissingParameterValueException

表示缺少必要的參數。

HTTP狀態碼:

ResourceNotFoundException

動作所需的資源不存在。

HTTP狀態碼:

ServiceUnavailableException

由於伺服器發生臨時故障,請求失敗。

HTTP狀態碼:5

另請參閱

如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: