CreateTags - Amazon Elastic File System

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

CreateTags

注意

棄用:CreateTags 已棄用且未維護。若要從 EFS 資源建立標籤,請使用 TagResource API 動作。

建立或覆寫與檔案系統相關聯的標籤。每個標籤都是金鑰值對。如果要求中指定的標籤鍵已存在於檔案系統上,此操作會以要求中提供的值覆寫其值。如果您將 Name 標籤新增至檔案系統,Amazon EFS 會在 DescribeFileSystems 回應操作時傳回該標籤。

這項操作需要 elasticfilesystem:CreateTags 動作的許可。

請求語法

POST /2015-02-01/create-tags/FileSystemId HTTP/1.1 Content-type: application/json { "Tags": [ { "Key": "string", "Value": "string" } ] }

URI 請求參數

請求會使用下列 URI 參數。

FileSystemId

您要修改其標籤的識別碼 (字串)。此操作只會修改標籤,而不會修改檔案系統。

長度限制:長度上限為 128。

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

必要:是

請求主體

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

Tags

新增的 Tag 物件陣列。每個 Tag 物件都是一個鍵值對。

類型:Tag 物件陣列

必要:是

回應語法

HTTP/1.1 204

回應元素

如果動作成功,則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

錯誤

BadRequest

如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。

HTTP 狀態碼:400

FileSystemNotFound

如果請求者的 AWS 帳戶 賬戶中不存在指定的 FileSystemId 值,則傳回。

HTTP 狀態碼:404

InternalServerError

如果在伺服器端發生錯誤,則傳回。

HTTP 狀態碼:500

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: