TagResource - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

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要添加的对象。AARYTag对象是键值对。

类型: 数组Tagobjects

:必需 是

响应语法

HTTP/1.1 200

响应元素

如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

Errors

AccessPointNotFound

返回指定的AccessPointId在请求者中不存在该值Amazon Web Services 账户.

HTTP 状态代码:404

BadRequest

如果请求格式不正确或包含错误,例如无效的参数值或缺少必需参数,则返回此选项。

HTTP 状态代码:400

FileSystemNotFound

返回指定的FileSystemId在请求者中不存在该值Amazon Web Services 账户.

HTTP 状态代码:404

InternalServerError

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

HTTP 状态代码:500

Examples

在文件系统上创建标签

以下请求创建三个标签("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 的更多信息,请参阅以下内容: