本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
-
该 ID 指定您要为其创建标签的 EFS 资源。
长度约束:长度上限为 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 格式的以下数据。
响应语法
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 的更多信息,请参阅以下内容: