创建流日志

最近更新时间:2018-01-19 15:34:07

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 流日志所属资源类型,VPC,SUBNET,NETWORKINTERFACE。
resourceId String 资源唯一 ID,例如 vpc-puz6fg,subnet-5o8ycyt,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。
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=VPC
  &resourceId=vpc-iqg1prdj
  &trafficType=ALL
  &cloudLogId=b4fd9ac1-7ce5-440d-92a7-10d9f04bdb34

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "flowLogId": "fl-q1b26f3p",
        "flowLogName": "test_caseyli",
        "resourceType": "VPC",
        "resourceId": "vpc-iqg1prjj",
        "TrafficType": "ALL",
        "CloudLogId": "b4fd9ac1-7ce5-440d-92a7-10d9f04bdb34",
        "createdTime": "0000-00-00 00:00:00"
    }
}