调用CreateFlowLog接口创建流日志。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateFlowLog

要执行的操作,取值: CreateFlowLog

LogStoreName String FlowLogStore

存储捕获到的流量的LogStore。

ProjectName String FlowLogProject

存储捕获到的流量的Project。

RegionId String cn-qingdao

流日志的所属地域。您可以通过调用DescribeRegions接口获取地域ID。

ResourceId String eni-askldfasza23****

要捕获流量的资源ID,支持输入专有网络、交换机、弹性网卡实例ID。

如果您的专有网络、交换机所属的专有网络、弹性网卡所属的专有网络中含有以下实例规格族中的任一实例,则不支持为该专有网络、交换机、弹性网卡创建流日志:

ecs.c1、ecs.c2、ecs.c4、ecs.c5、ecs.ce4、ecs.cm4、ecs.d1、ecs.e3、ecs.e4、ecs.ga1、ecs.gn4、ecs.gn5、ecs.i1、ecs.m1、ecs.m2、ecs.mn4、ecs.n1、ecs.n2、ecs.n4、ecs.s1、ecs.s2、ecs.s3、ecs.se1、ecs.sn1、ecs.sn2、ecs.t1、ecs.xn4。

如需创建流日志,请先升级实例规格。详细信息,请参见包年包月实例升级配置按量付费实例变更实例规格

说明 如果您的VPC中含有实例规格族限制中的任一实例,且您已经创建了流日志,为了保证正常使用流日志功能,请升级实例规格。
ResourceType String NetworkInterface

要捕获流量的资源类型,取值:

  • NetworkInterface:弹性网卡。
  • VSwitch:交换机内的所有弹性网卡。
  • VPC:专有网络内的所有弹性网卡。
TrafficType String all

采集的流量类型,取值:

  • All:全部流量。
  • Allow:访问控制允许的流量。
  • Drop:访问控制拒绝的流量。
FlowLogName String myFlowlog

流日志名称。

长度为2~128个字符,必须以字母或中文开头,可包含数字、点号(.)、下划线(_)和短横线(-)。但不能以http://https://开头。

Description String This is my Flowlog

流日志描述。

长度为2~256个字符,必须以字母或中文开头,但不能以http://https://开头。

返回数据

名称 类型 示例值 描述
FlowLogId String flowlog-m5evbtbptzsxdca****

流日志ID。

RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B457

请求ID。

Success String true

是否调用成功。

true:调用成功。

false:调用失败。

示例

请求示例

https://vpc.aliyuncs.com/?Action=CreateFlowLog
&LogStoreName=FlowLogStore
&ProjectName=FlowLogProject
&RegionId=cn-qingdao
&ResourceId=eni-askldfasza23****
&ResourceType=NetworkInterface
&TrafficType=all
&<公共请求参数>

正常返回示例

XML 格式

<CreateFlowLogResponse>
      <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B457</RequestId>
      <FlowLogId>flowlog-m5evbtbptzsxdca****</FlowLogId>
</CreateFlowLogResponse>

JSON 格式

{
    "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B457",
    "FlowLogId": "flowlog-m5evbtbptzsxdca****"
}

错误码

HttpCode 错误码 错误信息 描述
400 INVALID_PARAMETER The parameter invalid. 参数不合法。
400 MissingParameter Missing mandatory parameter 缺少必要参数,请您检查必填参数是否都已填后再进行操作。

访问错误中心查看更多错误码。