管理与支持产品文档捉虫活动邀您参加！> HOT
文档中心>API 中心>私有网络>私有网络 API 2017>流日志相关接口>创建流日志

创建流日志

最近更新时间：2019-09-25 15:56:15

我的收藏

本页目录：

1. 接口描述

本接口（CreateFlowLog）用于创建流日志。 接口请求域名：vpc.api.qcloud.com
1. 创建流日志前必须创建好私有网络、子网、弹性网卡。
2. 每个 私有网络、子网、弹性网卡 最多创建2个流日志。
3. 弹性网卡删除，会默认删除其关联的流日志。

2. 输入参数

以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，详情请参见 公共请求参数 页面。其中，此接口的 Action 字段为 CreateFlowLog。
参数名称
必选
类型
描述
vpcId
是
String
流日志所属的私有网络 ID 值，可使用 vpcId 或 unVpcId，建议使用 unVpcId。可通过 DescribeVpcEx 接口查询。
flowLogName
是
String
流日志名称。
flowLogDescription
否
String
流日志描述，默认为""，可选项。
resourceType
是
String
流日志所属资源类型，NETWORKINTERFACE。
resourceId
是
String
资源唯一 ID，如 eni-08dhim。
trafficType
是
String
流日志采集类型，ACCEPT，REJECT， ALL。
cloudLogId
是
String
流日志存储 ID, 暂时只支持日志服务 ID，例如 d44e4cf0-c3e2-48d9-bb64-c5f0337ef2b0。

3. 输出参数

参数名称
类型
描述
code
Int
公共错误码，0表示成功，其他值表示失败。详见错误码页面的 公共错误码。
message
String
模块错误信息描述，与接口相关。
flowLogId
String
流日志唯一 ID，示例：fl-q1b26f3d。
flowLogName
String
流日志名字。
resourceType
String
流日志资源类型。
resourceId
String
流日志资源 ID。
TrafficType
String
流日志采集类型。
CloudLogId
String
流日志存储 ID。
CloudLogState
String
流日志存储 ID 的状态，是否可用。可选 当为空时不输出。
FlowLogDescription
String
流日志描述。可选 当为空时不输出。
createdTime
String
流日志创建时间。

4. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码，更多公共错误码详见 VPC错误码。
错误码
描述
InvalidVpc.NotFound
无效的 VPC，VPC 资源不存在，请再次核实您输入的资源信息是否正确，可通过 DescribeVpcEx 接口查询 VPC。
InvalidSubnet.NotFound
无效的子网。子网资源不存在，请再次核实您输入的资源信息是否正确，可通过 DescribeSubnetEx 接口查询子网。
InvalidNetworkInterface.NotFound
无效的弹性网卡，弹性网卡资源不存在。请再次核实您输入的资源信息是否正确，可通过 DescribeNetworkInterfaces 接口查询弹性网卡。
InvalidFlowLogName
流日志名称不合法, 可任意命名，但不得超过60个字符。
FlowLogNameDuplicate
流日志名称已经存在, 可任意命名，但不得超过60个字符。

5. 示例

输入
https://vpc.api.qcloud.com/v2/index.php?Action=CreateFlowLog
    &<公共请求参数>
  vpcId=vpc-iqg1sdjj
  &flowLogName=test_flowlog
  &resourceType=NETWORKINTERFACE
  &resourceId=eni-08dhim
  &trafficType=ALL
  &cloudLogId=b4fd9ac1-7ce5-440d-92a7-10d9f04bdb34
输出
{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "flowLogId": "fl-q1b26f3p",
        "flowLogName": "test_caseyli",
        "resourceType": "NETWORKINTERFACE",
        "resourceId": "eni-08dhim",
        "TrafficType": "ALL",
        "CloudLogId": "b4fd9ac1-7ce5-440d-92a7-10d9f04bdb34",
        "createdTime": "0000-00-00 00:00:00"
    }
}


中国站
目录