本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
TagResource
將一組鍵值對指派給由 Amazon Resource Name () 識別的復原點、備份計畫或備份保存庫ARN。
API 支援 Aurora、Amazon DocumentDB 等資源類型的復原點。Amazon EBS、Amazon FSx、Neptune 和 Amazon RDS。
請求語法
POST /tags/resourceArn
HTTP/1.1
Content-type: application/json
{
"Tags": {
"string
" : "string
"
}
}
URI 請求參數
請求使用以下URI參數。
- resourceArn
-
ARN 唯一識別資源的 。的格式ARN取決於已標記資源的類型。
ARNs 不包含
backup
的 與標記不相容。TagResource
且UntagResource
無效ARNs將導致 錯誤。可接受的ARN內容可以包含arn:aws:backup:us-east
。無效ARN的內容可能看起來像arn:aws:ec2:us-east
。必要:是
請求主體
請求接受下列JSON格式的資料。
- Tags
-
用於協助組織資源的鍵值對。您可以將自己的中繼資料指派給所建立的資源。為了清楚起見,下列是指派標籤的結構:
[{"Key":"string","Value":"string"}]
。類型:字串到字串映射
必要:是
回應語法
HTTP/1.1 200
回應元素
如果動作成功,服務會傳回 200 HTTP 回應,其中內HTTP文為空白。
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- InvalidParameterValueException
-
表示參數的值出現問題。例如,值超出範圍。
HTTP 狀態碼:400
- LimitExceededException
-
請求已超過限制;例如,請求中允許的最大項目數量。
HTTP 狀態碼:400
- MissingParameterValueException
-
表示缺少必要的參數。
HTTP 狀態碼:400
- ResourceNotFoundException
-
動作所需的資源不存在。
HTTP 狀態碼:400
- ServiceUnavailableException
-
由於伺服器發生臨時故障,請求失敗。
HTTP 狀態碼:500
另請參閱
如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: