TagResource - Amazon Elastic File System
请求语法URI 请求参数请求正文响应语法响应元素错误示例另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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值不存在，则返回Amazon Web Services 账户。

HTTP 状态代码：404

BadRequest

如果请求格式错误或包含错误（例如参数值无效或缺少必需参数），则返回。

HTTP 状态代码：400

FileSystemNotFound

如果请求者的指定FileSystemId值不存在，则返回Amazon Web Services 账户。

HTTP 状态代码：404

InternalServerError

如果服务器端发生错误，则返回。

HTTP 状态代码：500

示例

在文件系统上创建标签

以下请求在指定的文件系统上创建了三个标签（"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

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：