调用AddTags添加或者覆盖一个或者多个标签到一个文件系统实例。

接口说明

说明 标签功能已全面升级,该文档即将下线,相关文档请参见TagResources。
  • 每个标签(Tag)由标签键(TagKey)和标签值(TagValue)组成。
  • 标签键和标签值会自动去除头尾的占位符,例如:空格、\t、\n、\r。
  • 标签键不允许为空,标签值可为空。
  • 标签键和标签值不区分大小写。
  • 标签键最长为64个字符,标签值最长为128个字符。
  • 每个实例最多绑定10个标签,对于相同标签键进行重复绑定的标签,则后绑定的标签将覆盖之前的标签。
  • 如果一个标签所绑定的文件系统实例全都解绑,则该标签自动删除。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AddTags

系统规定参数。取值:AddTags。

FileSystemId String 0addcw****

文件系统ID。

Tag.N.Key String keyN

当前第N组标签键。需要绑定的标签,包括标签键和标签值,单次最多支持传入10组值。标签键不能为空,标签值可以为空。

Tag.N.Value String valueN

当前第N组标签值。需要绑定的标签,包括标签键和标签值,单次最多支持传入10组值。标签键不能为空,标签值可以为空。

返回数据

名称 类型 示例值 描述
RequestId String 98696EF0-1607-4E9D-B01D-F20930B68845

请求ID。

示例

请求示例

GET https://nas.cn-hangzhou.aliyuncs.com/?Action=AddTags
&FileSystemId=109c04****
&Tag.1.Key=test_key
&Tag.1.Value=test_value
&<公共请求参数>

正常返回示例

XML格式

<AddTagsResponse>
    <RequestId>98696EF0-1607-4E9D-B01D-F20930B68845</RequestId>
</AddTagsResponse>

JSON格式

{
  "RequestId":"98696EF0-1607-4E9D-B01D-F20930B68845"
}

错误码

访问错误中心查看更多错误码。