You need to enable JavaScript to run this app.
导航
更新服务存储策略
最近更新时间:2024.01.31 15:20:04首次发布时间:2024.01.31 15:20:04

本接口支持更新指定服务的存储策略。

注意事项

  • 请求频率:单用户请求频率限制为 500 次/秒
  • 超时时间:超时时间约为 20 秒
  • 服务地址:veImageX 在全球多个区域部署,每个区域有自己对应的 OpenAPI 域名,不支持跨区域调用。详情参见服务地址

请求说明

  • 请求方式:POST
  • 请求地址:https://imagex.volcengineapi.com/?Action=UpdateStorageRules&Version=2023-05-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数

Query

参数类型是否必选示例值描述
ActionStringUpdateStorageRules接口名称。当前 API 的名称为 UpdateStorageRules
VersionString2023-05-01接口版本。当前 API 的版本为 2023-05-01

ServiceId

String

7s**0l

服务 ID。

  • 您可以在 veImageX 控制台 服务管理页面,在创建好的图片服务中获取服务 ID。
  • 您也可以通过 OpenAPI 的方式获取服务 ID,具体请参考获取所有服务信息

Body

参数类型是否必选示例值描述
StorageRulesArray of StorageRules-更新后的存储降冷策略

StorageRules

参数类型是否必选示例值描述

Prefix

String

prefix

文件前缀。例如设置为 prefix 后,规则将只对名称以 prefix 开头的存储资源生效。输入规则如下:

  • 不能以正斜线(/)或者反斜线(\)开头;
  • 不支持使用正则表达式匹配前缀;
  • 长度为 1~1024 个字符。
EventStringupload策略类型,固定取值 Upload,表示按上传时间。
DayInteger30策略天数,取值范围为 [1,365],单位为天。按照 Event 事件 Day 天后执行 Action 事件,即当匹配文件的上传时间符合指定天数后,自动按照处理策略对资源进行处理。

Action

String

IA

策略命中后需要执行的操作,取值如下所示:

  • DELETE:删除文件
  • IA:文件转低频存储
  • ARCHIVE:文件转归档存储
  • COLD_ARCHIVE:文件转冷归档存储

Enable

Boolean

true

是否启用策略,取值如下所示:

  • true:是
  • false:否

返回参数

本接口暂无特定的返回参数。更多信息请见公共返回参数

请求示例

POST https://imagex.volcengineapi.com/?Action=UpdateStorageRules&Version=2023-05-01&ServiceId=7s**0l
{
    "StorageRules": [
        {
            "Prefix": "prefix",
            "Event": "upload",
            "Day": 30,
            "Action": "IA",
            "Enable": true
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202306041104200100100232280022D31",
        "Action": "UpdateStorageRules",
        "Version": "2023-05-01",
        "Service": "ImageX",
        "Region": "cn-north-1"
    },
    "Result": {}
}

错误码

本接口无特有的错误码。更多信息请见公共错误码和 veImageX 错误码