TagResource - AWS Transfer Family
请求语法请求参数响应元素错误示例另请参阅

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

TagResource

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

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

请求语法

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

请求参数

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

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

Arn

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

类型：字符串

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

模式：arn:\S+

必需：是

Tags

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

类型：Tag 对象数组

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

必需：是

响应元素

如果操作成功，服务将发回 HTTP 200 响应，HTTP正文为空。

错误

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

InternalServiceError

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

HTTP状态码：500

InvalidRequestException

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

HTTP状态码：400

ResourceNotFoundException

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

HTTP状态码：400

ServiceUnavailableException

请求失败，因为 Trans AWS 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.

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs，请参阅以下内容：