调用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个字符,不能以 |
Description | String | 否 | This is my Flowlog. | 要修改的流日志描述。 描述长度为1~256个字符,不能以 |
AggregationInterval | Integer | 否 | 1 | 要修改的流日志的采样间隔。单位:分钟。取值:1、5、10。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Success | String | true | 操作是否成功。取值:
|
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. | 操作托管的流日志,鉴权失败。 |
访问错误中心查看更多错误码。