此页面仅适用于使用保管库的 S3 Glacier 服务的现有客户以及 2012 年以RESTAPI来的原始客户。
如果您正在寻找档案存储解决方案,我们建议您在亚马逊 S3、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier Deep Archive Dee p Archive 中使用 S3 Glacier 存储类。要了解有关这些存储选项的更多信息,请参阅 Amazon S3 用户指南中的 S3 Glacier 存储类
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
从文件库删除标签(POST 标签删除)
此操作会从已附加到文件库的标签集中删除一个或多个标签。有关标签的更多信息,请参阅 标记 Amazon S3 Glacier 资源。
此操作是幂等的。即使没有已附加到文件库的标签,此操作也将会成功。
请求语法
要从文件库中删除标签,请将 HTTP POST 请求发送到标签 URI,如以下语法示例中所示。
POST /
AccountId
/vaults/vaultName
/tags?operation=remove HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
Content-Length:Length
x-amz-glacier-version: 2012-06-01 { "TagKeys": [ "string
", "string
" ] }
注意
AccountId
值为 Amazon Web Services 账户 ID。此值必须与用来对请求进行签名的凭证相关联的 Amazon Web Services 账户 ID 相匹配。您可以指定 Amazon Web Services 账户 ID,也可以选择指定“-
”(连字符),在这种情况下,Amazon S3 Glacier 使用与用来对请求进行签名的凭证相关联的 Amazon Web Services 账户 ID。如果您指定账户 ID,请勿在 ID 中包含连字符 ('-')。
请求参数
名称 | 描述 | 必填 |
---|---|---|
operation=remove
|
带有 |
是 |
请求标头
此操作仅使用所有操作通用的请求头。有关通用请求头的信息,请参阅常见请求标头。
请求正文
请求正文中包含以下 JSON 字段。
- TagKeys
-
标签键的列表。从文件库中删除每个对应的标签。
类型:字符串的数组
长度约束:列表中最少 1 个项。列表中最多 10 个项。
必需:是
响应
如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 204 No Content
响应。
语法
HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date
响应标头
此操作仅使用大多数响应通用的响应头。有关通用响应头的信息,请参阅常用响应标头。
响应正文
此操作不返回响应正文。
错误
有关 Amazon S3 Glacier 异常和错误消息的信息,请参阅错误响应。
示例
示例请求
以下示例发送一个 HTTP POST 请求以删除指定的标签。
POST /-/vaults/examplevault/tags?operation=remove HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 Content-Length:
length
x-amz-glacier-version: 2012-06-01 { "TagsKeys": [ "examplekey1", "examplekey2" ] }
响应示例
如果请求成功,Amazon S3 Glacier (S3 Glacier) 会返回 HTTP 204 No
Content
,如以下示例中所示。
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT
相关部分
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: