调用CreateFlowLog接口创建流日志。

调试

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

请求参数

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

系统规定参数。取值：CreateFlowLog。

RegionId String 是 cn-qingdao

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

FlowLogName String 否 myFlowlog

流日志名称。

长度为2~128个字符，必须以字母或中文开头，可包含数字，半角句号（.），下划线（_）和短划线（-）。
Description String 否 This is my Flowlog.

流日志描述。

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

ResourceType String 是 NetworkInterface

要捕获流量的资源类型。取值：

  • NetworkInterface：弹性网卡。
  • VSwitch：交换机内的所有弹性网卡。
  • VPC：专有网络内的所有弹性网卡。
ResourceId String 是 eni-askldfas****

要捕获流量的资源ID。
TrafficType String 是 All

采集的流量类型。取值：

  • All：全部流量。
  • Allow：访问控制允许的流量。
  • Drop：访问控制拒绝的流量。
ProjectName String 是 FlowLogProject

存储捕获到的流量的Project名称。

  • Projec名称仅支持小写字母、数字和短划线（-）。
  • 名称的开头与结尾必须为小写字母或数字。
  • 名称长度为3~63个字符。
LogStoreName String 是 FlowLogStore

存储捕获到的流量的LogStore名称。

  • LogStore名称仅支持小写字母、数字、短划线（-）和下划线（_）。
  • 名称的开头与结尾必须为小写字母或数字。
  • 名称长度为3~63个字符。
AggregationInterval Integer 否 10

流日志的采样间隔。单位：秒。取值：1、5、10（默认值）。

返回数据

名称 类型 示例值 描述
RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B457

请求ID。
Success String true

是否调用成功。取值：

  • true：调用成功。
  • false：调用失败。
FlowLogId String fl-m5e8vhz2t21sel1nq****

流日志ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateFlowLog
&RegionId=cn-qingdao
&FlowLogName=myFlowlog
&Description=This is my Flowlog.
&ResourceType=NetworkInterface
&ResourceId=eni-askldfas****
&TrafficType=All
&ProjectName=FlowLogProject
&LogStoreName=FlowLogStore
&AggregationInterval=10
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateFlowLogResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B457</RequestId>
    <Success>true</Success>
    <FlowLogId>fl-m5e8vhz2t21sel1nq****</FlowLogId>
</CreateFlowLogResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B457",
  "Success" : "true",
  "FlowLogId" : "fl-m5e8vhz2t21sel1nq****"
}

错误码

HttpCode 错误码 错误信息 描述
400 OperationUnsupported.AdvancedFeature Advanced features of the vpc is unsupported. 不支持该高级特性。
400 INVALID_PARAMETER The parameter invalid. 参数不合法。
400 MissingParameter Missing mandatory parameter 缺少必要参数，请您检查必填参数是否都已填后再进行操作。
400 IllegalParam.AggregationInterval The param of aggregationInterval is illegal. 采样间隔参数输入不合法

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