文档首页/ 虚拟私有云 VPC/ API参考/ API V1/V2/ 流日志/ 更新流日志 - UpdateFlowLog
更新时间：2025-12-16 GMT+08:00
查看PDF
分享

更新流日志 - UpdateFlowLog

功能介绍

更新流日志。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    vpc:flowLogs:update

    Write

    flowLog *
    • vpc:FlowLogId
    • vpc:FlogLogResourceType

    -

    -

URI

PUT /v1/{project_id}/fl/flow_logs/{flowlog_id}

参数说明请参见表1。

表1 参数说明

名称

是否必选

参数类型

说明

project_id

是

String

项目ID，请参见获取项目ID。

flowlog_id

是

String

流日志ID

请求参数

表2 请求参数

名称

是否必选

参数类型

说明

flow_log

是

flow_log object

FlowLog对象，请参见表3。
表3 FlowLog字段说明

名称

是否必选

参数类型

说明

name

否

String
  • 功能说明：流日志名称
  • 取值范围：0-64个字符，支持数字、字母、中文字符、_（下划线）、-（中划线）、.（点）

description

否

String
  • 功能说明：流日志描述
  • 取值范围：0-255个字符，不能包含“<”和“>”

admin_state

否

Boolean
  • 功能说明：是否开启流日志
  • 取值范围：
    • true：表明开启流日志。
    • false：表示关闭流日志。

请求示例

  • 更新id为f49f00f1-0f15-470a-a8c5-4e879e461c8d的流日志，名称更新为flow-log-update。 
    PUT https://{Endpoint}/v1/b2782e6708b8475c993e6064bc456bf8/fl/flow_logs/f49f00f1-0f15-470a-a8c5-4e879e461c8d

{
    "flow_log": {
        "name": "flow-log-update",
        "description": "update",
        "admin_state": false
    }
}

响应参数

表4 响应参数

名称

参数类型

说明

flow_log

flow_log object

FlowLog对象，请参见表5
表5 FlowLog对象说明

名称

参数类型

说明

id

String
  • 功能说明：流日志ID

name

String
  • 功能说明：流日志名称
  • 取值范围：0-64个字符，支持数字、字母、中文字符、_（下划线）、-（中划线）、.（点）

tenant_id

String
  • 功能说明：项目ID

description

String
  • 功能说明：流日志描述
  • 取值范围：0-255个字符，不能包含“<”和“>”

resource_type

String
  • 功能说明：流日志采集的资源类型
  • 取值范围：
    • port：单个网卡。
    • vpc：VPC内所有的网卡。
    • network：子网内所有的网卡。

resource_id

String
  • 功能说明：要采集的资源ID

traffic_type

String
  • 功能说明：流日志采集类型
  • 取值范围：
    • all：采集指定资源的全部流量。
    • accept：采集指定资源允许传入、传出的流量。
    • reject：采集指定资源拒绝传入、传出的流量。

log_group_id

String
  • 功能说明：日志组ID。

请在云日志服务中获取，详情请参见《云日志服务用户指南》。

log_topic_id

String
  • 功能说明：日志主题ID。

请在云日志服务中获取，详情请参见《云日志服务用户指南》。

log_store_type

String
  • 功能说明：流日志存储类型。
  • 取值范围：
    • lts：存储类型为云日志服务（LTS）。

admin_state

Boolean
  • 功能说明：是否开启流日志
  • 取值范围：
    • true：表明开启流日志。
    • false：表示关闭流日志。

status

String
  • 功能说明：流日志状态
  • 取值范围：
    • ACTIVE：开启
    • DOWN：关闭
    • ERROR：异常故障

created_at

String
  • 功能说明：流日志创建时间
  • 取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss

updated_at

String
  • 功能说明：流日志更新时间
  • 取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss

响应示例

{
    "flow_log": {
        "id": "f49f00f1-0f15-470a-a8c5-4e879e461c8d",
        "name": " flow-log-update",
        "description": "update",
        "tenant_id": "b2782e6708b8475c993e6064bc456bf8",
        "resource_type": "port",
        "resource_id": "05c4052d-8d14-488f-aa00-19fea5a25fde",
        "traffic_type": "reject",
        "log_group_id": "05c4052d-8d14-488f-aa00-19fea5a25fdd",
        "log_topic_id": "a9d7dee7-37d2-4cba-a208-a016252aaa63",
        "log_store_type": "lts",
        "created_at": "2019-01-14T11:03:02",
        "updated_at": "2019-01-14T12:03:02",
        "status": "DOWN",
        "admin_state": false
    }
}

状态码

请参见状态码。

错误码

请参考错误码。

父主题： 流日志

相关文档