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

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

TagResource

将通过 Amazon 资源名称 (ARN) 标识的键/值对附加到资源。资源是用户、服务器、角色和其他实体。

此次调用未返回任何回应。

请求语法

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

请求参数

有关所有操作的通用参数的信息，请参阅通用参数。

请求接受采用 JSON 格式的以下数据。

Arn

特定资源（例如服务器、用户或角色）的 Amazon Amazon 资源名称 (ARN)。

类型：字符串

长度约束：最小长度为 20。长度上限为 1600。

模式：arn:\S+

必需：是

Tags

分配给 ARN 的键值对，可用于按类型对资源进行分组和搜索。您可以出于任何目的将此元数据附加到资源（服务器、用户、工作流程等）。

类型：Tag 对象数组

数组成员：最少 1 个物品。最多 50 项。

必需：是

响应元素

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

错误

有关所有操作的常见错误信息，请参阅常见错误。

InternalServiceError

当 Amazon Transfer Family 服务中发生错误时，会引发此异常。

HTTP 状态代码：500

InvalidRequestException

当客户端提交格式错误的请求时，会引发此异常。

HTTP 状态代码：400

ResourceNotFoundException

当 Transfer Family 服务找不到资源时，就会 Amazon引发此异常。

HTTP 状态代码：400

ServiceUnavailableException

请求失败，因为 Trans Amazon fer Family 服务不可用。

HTTP 状态代码：500

示例

示例

以下示例向启用文件传输协议的服务器添加标签。

示例请求


{
   "Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef",
   "Tags": [ 
      { 
         "Key": "Group",
         "Value": "Europe"
      }
   ]
}

示例

此示例说明了的一种用法 TagResource。

示例响应


          HTTP 200 response with an empty HTTP body.

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：