调用ModifyFlowLogAttribute接口修改流日志的属性。

使用说明

  • ModifyFlowLogAttribute接口属于异步接口,即系统会返回一个请求ID,但该流日志尚未修改成功,系统后台的修改任务仍在进行。您可以调用DescribeFlowLogs查询流日志的修改状态:
    • 当流日志处于Modifying状态时,表示流日志正在修改中。
    • 当流日志处于Active或者Inactive状态时,表示流日志修改成功。
  • ModifyFlowLogAttribute接口不支持并发修改同一个流日志的属性。

调试

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

请求参数

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

系统规定参数。取值:ModifyFlowLogAttribute

RegionId String cn-qingdao

流日志所属的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

FlowLogId String fl-m5e8vhz2t21sel1nq****

流日志ID。

FlowLogName String myFlowlog

要修改的流日志名称。

名称长度为1~128个字符,不能以http://https://开头。

Description String This is my Flowlog.

要修改的流日志描述。

描述长度为1~256个字符,不能以http://https://开头。

AggregationInterval Integer 1

要修改的流日志的采样间隔。单位:分钟。取值:1510

返回数据

名称 类型 示例值 描述
Success String true

操作是否成功。取值:

  • true:操作成功。
  • false:操作失败。
RequestId String F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyFlowLogAttribute
&RegionId=cn-qingdao
&FlowLogId=fl-m5e8vhz2t21sel1nq****
&FlowLogName=myFlowlog
&Description=This is my Flowlog.
&AggregationInterval=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyFlowLogAttributeResponse>
    <Success>true</Success>
    <RequestId>F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1</RequestId>
</ModifyFlowLogAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Success" : true,
  "RequestId" : "F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1"
}

错误码

HttpCode 错误码 错误信息 描述
400 IncorrectBusinessStatus.FlowLog The business status of flowLog is incorrect. 当前业务状态不支持创建流日志实例
400 InvalidInstanceId Instance does not exist. 实例不存在。
400 ProjectOrLogstoreNotExist The specified project or logstore does not exist. 指定的项目或logstore不存在。
400 SourceProjectNotExist The Source Project or logstore does not exist. SLS源项目或日志库不存在。
400 Unauthorized This api does not support sub user or role. 此API不支持子用户或角色。
400 IncorrectStatus.flowlog Invalid flowlog status. flowlog状态无效,无法停止
400 IllegalParam.AggregationInterval The param of aggregationInterval is illegal. 采样间隔参数输入不合法
400 Forbidden.OperateManagedFlowLog Authentication is failed for operate managed flowlog. 操作托管的流日志,鉴权失败。

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