ModifySlsDispatchConfig - 修改日志投递配置

更新时间:
复制 MD 格式

修改SLS投递相关配置

接口说明

在使用该接口之前,请先使用 DescribeUserBuyVersion 获取用户的 LogVersion。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

ModifyType

string

修改类型。可选值:

  • version:版本改变。比如由 1(投递目标为 1 个 logstore)变为 2(投递目标为 2 个 logstore)。

  • config:配置改变。比如修改日志投递区域,日志存储时长等。

枚举值:

  • version :

    版本

  • config :

    配置

version

LogVersion

integer

日志版本。1:代表有 1 个 logStore,2:代表有两个 logStore。

重要 如果 ModifyType=version,则 LogVersion 要填写目标版本,如果 ModifyType=config,则 LogVersion 要填写用户当前版本。

枚举值:

  • 1 :

    版本 1

  • 2 :

    版本 2

1

DetailConfig

string

要修改的详细的配置。

版本 1 的格式

{"global":{"slsRegionId":"cn-hangzhou","logTime":180,"logStorage":1000}}

版本 2 的格式

{"cn":{"slsRegionId":"cn-hangzhou","logTime":180,"logStorage":3000},"intl":{"slsRegionId":"ap-southeast-1","logTime":180,"logStorage":2000}}
各字段含义如下:
  • slsRegionId:用户投递的目标 RegionId。

  • logTime:日志存储时长,单位(天)。

  • logStorage:日志存储容量,单位(GB),传入的容量之和不应大于用户购买的总容量。

{"global":{"slsRegionId":"cn-hangzhou","logTime":180,"logStorage":1000}}

返回参数

名称

类型

描述

示例值

object

RequestId

string

本次调用请求的 ID。

4CD646BA-490F-5584-9272-B6FFE3BB****

TaskId

string

任务 ID。修改日志配置为异步任务,该字段代表任务的唯一标识,后续可以用该 ID 查询对应任务的状态。

d8c995ec-40a5-4382-a3f3-57713096****

示例

正常返回示例

JSON格式

{
  "RequestId": "4CD646BA-490F-5584-9272-B6FFE3BB****",
  "TaskId": "d8c995ec-40a5-4382-a3f3-57713096****"
}

错误码

HTTP status code

错误码

错误信息

描述

400 IllegalOperation Illegal operation, unable to operate within 5 minutes, please try again in 5 minutes. 非法操作, 5分钟内不能操作, 请5分钟后重试.
400 RepeatInFiveMinutes Repeat operation in five minutes, please try later. 五分钟之内不允许重复操作,请稍后再试。

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

变更历史

更多信息,参考变更详情