TagResource - Amazon Elastic File System
請求語法URI請求參數請求主體回應語法回應元素錯誤範例另請參閱

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

TagResource

建立EFS資源的標籤。您可以使用此API操作為EFS檔案系統和存取點建立標籤。

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

請求語法

POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json

{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URI請求參數

請求使用下列URI參數。

ResourceId

指定您要為其建立標籤之EFS資源的 ID。

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

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

必要：是

請求主體

請求接受以下JSON格式的數據。

Tags

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

類型：Tag 物件陣列

必要：是

回應語法

HTTP/1.1 200

回應元素

如果動作成功，服務會傳回含有空HTTP主體的 HTTP 200 回應。

錯誤

AccessPointNotFound

如果請求者中不存在指定的AccessPointId AWS 帳戶值，則返回。

HTTP狀態碼:

BadRequest

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

HTTP狀態碼:

FileSystemNotFound

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

HTTP狀態碼:

InternalServerError

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

HTTP狀態碼:5

範例

建立檔案系統標籤

下列請求會在指定的檔案系統上建立三個標籤 ("key1"、"key2"、和 "key3")。

請求範例

POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
    "Tags": [
        {
            "Key": "key1",
            "Value": "value1"            
        },
        {
            "Key": "key2",
            "Value": "value2"            
        },
        {
            "Key": "key3",
            "Value": "value3"            
        }
    ]
}

回應範例

HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef

另請參閱

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