调用ModifyFlowLogAttribute接口编辑流日志的名称和描述。
接口说明
- ModifyFlowLogAttribute 接口属于异步接口,即系统会返回一个请求 ID,但该流日志尚未修改成功,系统后台的修改任务仍在进行。您可以调用 DescribeFlowLogs 查询流日志的修改状态:
当流日志处于 Modifying 状态时,表示流日志正在修改中。
当流日志处于 Active 或者 Inactive 状态时,表示流日志修改成功。
ModifyFlowLogAttribute 接口不支持并发修改同一个流日志的属性。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vpc:ModifyFlowLogAttribute |
update |
*FlowLog
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
流日志所属的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-qingdao |
| FlowLogId |
string |
是 |
流日志 ID。 |
fl-m5e8vhz2t21sel1nq**** |
| FlowLogName |
string |
否 |
要修改的流日志名称。 名称长度为 1~128 个字符,不能以 |
myFlowlog |
| Description |
string |
否 |
要修改的流日志描述。 描述长度为 1~256 个字符,不能以 |
This is my Flowlog. |
| AggregationInterval |
integer |
否 |
要修改的流日志的采样间隔。单位:分钟。取值:1、5、10。 |
1 |
| IpVersion |
string |
否 |
流日志采集流量的 IP 地址类型。 |
IPv4 |
| LogFormat |
string |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
请求 ID。 |
||
| Success |
string |
操作是否成功。取值:
|
true |
| RequestId |
string |
请求 ID。 |
F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1 |
示例
正常返回示例
JSON格式
{
"Success": "true",
"RequestId": "F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 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 | InvalidInstanceId.NotFound | The specfied instance is not existed. | |
| 400 | RuleExist | The rule has already existed. | |
| 400 | InvalidHdMonitorStatus | Current instance status is not valid for this action. | |
| 400 | FlowLogNumberOverLimit | This user has reached the maximum instance number of flowlog. | |
| 400 | InvalidTrafficType.NotFound | Invalid traffic type. | |
| 400 | IncorrectStatus.flowlog | Invalid flowlog status. | flowlog状态无效,无法停止 |
| 400 | InvalidName.Malformed | The specified name is not valid. | |
| 400 | IllegalParam.AggregationInterval | The param of aggregationInterval is illegal. | 采样间隔参数输入不合法 |
| 400 | Forbidden.OperateManagedFlowLog | Authentication is failed for operate managed flowlog. | 操作托管的流日志,鉴权失败。 |
| 400 | UnsupportedFeature.IpVersion | The ipversion type is not supported. | 输入的ipVersion不支持 |
| 400 | IllegalParam.IpVersion | The parameter of IpVersion is illegal. | 参数IpVersion非法。 |
| 400 | OperationDenied.NisTrafficAnalyzerAggregationIntervalMismatch | The sampling interval of the FlowLog is greater than the sampling interval of the NIS Traffic Analyzer. | FlowLog的采样间隔大于NIS流量分析器的采样间隔。 |
| 400 | OperationDenied.NisTrafficAnalyzerNotActive | The specified NIS Traffic Analyzer is not enabled. | 指定的NIS流量分析器处于非开启状态。 |
| 400 | OperationDenied.NisTrafficAnalyzerNotFound | The specified NIS Traffic Analyzer does not exist. | 指定的NIS流量分析器不存在。 |
| 400 | OperationFailed.InternalError | The request processing has failed due to some unknown error. | 未知错误,请重试操作,错误仍存在请提交工单处理。 |
| 400 | OperationDenied.InvalidInstanceDeliverScope | When modifying the delivery purpose of the FlowLog instance or starting and stopping NIS traffic analysis, you specify the type of delivery that is not allowed. | 在修改FlowLog实例的投递目的或者启停NIS流量分析时,指定了不被允许的投递类型。 |
| 400 | IllegalParam.LogFormat | The specified parameter of LogFormat is invalid. | 指定的LogFormat参数非法 |
| 400 | OperationDenied.UnsupportedField | LogFormat contains unsupported fields. | LogFormat包含了不支持的字段 |
| 400 | UnsupportedFeature.LogFormat | The ability to customize subscription fields for flow logs is not yet available, so stay tuned. | 流日志自定义订阅字段的功能尚未开放,敬请期待。 |
| 400 | UnsupportedFeature.LogFormatNisTrafficAnalyze | The flow log for which NIS traffic analysis is enabled does not support custom subscription fields. | 开启了NIS流量分析的流日志,暂不支持自定义订阅字段 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。