1. 接口描述
本接口(CreateFlowLog)用于创建流日志。
接口请求域名:vpc.api.qcloud.com
- 创建流日志前必须创建好私有网络、子网、弹性网卡。
- 每个 私有网络、子网、弹性网卡 最多创建2个流日志。
- 弹性网卡删除,会默认删除其关联的流日志。
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"
}
}