文档

CreateFlowLog - 创建一个流日志

更新时间:

调用CreateFlowlog接口创建流日志实例。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
smartag:CreateFlowLogWrite
  • FlowLog
    acs:smartag:{#regionId}:{#accountId}:flowlog/*

请求参数

名称类型必填描述示例值
RegionIdstring

流日志实例的地域 ID。

您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-shanghai
Descriptionstring

流日志实例的描述。

test
Namestring

流日志实例的名称。

sag-flowlog-1
ActiveAginginteger

活跃流输出间隔。取值范围:60~6000,单位:秒。默认值为 300 秒。

300
InactiveAginginteger

非活跃流输出间隔。取值范围:10~600,单位:秒。默认值为 15 秒。

15
OutputTypestring

流日志输出类型,取值:

  • sls:流日志存储在阿里云日志服务中。

  • netflow:流日志存储在您配置的 Netflow 服务器上。

  • all:流日志同时存储在阿里云日志服务和您配置的 Netflow 服务器上。

all
SlsRegionIdstring

日志服务的地域 ID。

流日志输出类型为 slsall 时需填写该项。

cn-shanghai
ProjectNamestring

日志服务的 Project。

流日志输出类型为 slsall 时需填写该项。

sag-flowlog-shanghai
LogstoreNamestring

日志服务的 Logstore。

流日志输出类型为 sls 或者 all 时需填写该项。

config-operation-log
NetflowServerIpstring

存储流日志的 Netflow 服务器地址。

流日志输出类型为 netflowall 时需填写该项。

192.168.0.2
NetflowServerPortinteger

存储流日志的 Netflow 服务器端口,默认值为 9995

流日志输出类型为 netflowall 时需填写该项。

9995
NetflowVersionstring

存储流日志时使用的 Netflow 协议版本号,取值:V5V9V10,默认值为 V9

流日志输出类型为 netflowall 时需填写该项。

V9

返回参数

名称类型描述示例值
object

流日志实例信息。

RequestIdstring

请求 ID。

650CB9E8-20F3-4538-A4FC-1DA1B36E42D9
FlowLogIdstring

流日志实例 ID。

fl-7a56mar1kfw9vj****
ResourceGroupIdstring

流日志实例所属资源组 ID。

rg-acfm2iu4f****

示例

正常返回示例

JSON格式

{
  "RequestId": "650CB9E8-20F3-4538-A4FC-1DA1B36E42D9",
  "FlowLogId": "fl-7a56mar1kfw9vj****",
  "ResourceGroupId": "rg-acfm2iu4f****"
}

错误码

HTTP status code错误码错误信息描述
400DependencyViolation.FlowLogThis FlowLog instance is bound to an SAG instance.FlowLog存在资源依赖。
400IncorrectStatus.FlowLogThe current FlowLog instance status does not support this operation.FlowLog状态非法。
400InvalidFlowLogId.NotFoundThe specified FlowLogId does not exist.根据FlowLogId未找到对应实例。
400MissingParam.FlowLogIdSpecify the FlowLogId parameter.缺少参数FlowLogId。
400OperationFailed.AssociateFlowLogThe operation failed. The specified SAG instance has already been associated with another FlowLog instance.由于智能接入网关实例已经关联其他FlowLog实例,操作失败。
400OperationUnsupported.AssociateFlowLogYou cannot bind the SAG device of the current version or model to a FlowLog instance.设备版本或者款型不支持关联FlowLog操作。
400QuotaExceeded.FlowlogThe maximum number of FlowLog instances is exceeded.flowlog数量超过配额。
400MissingParam.LogstoreNameSpecify the LogstoreName parameter.缺少参数LogstoreName。
400MissingParam.NetflowServerIpSpecify the NetflowServerIp parameter.缺少参数NetflowServerIp。
400MissingParam.NetflowServerPortSpecify the NetflowServerPort parameter.缺少参数NetflowServerPort。
400MissingParam.NetflowVersionSpecify the NetflowVersion parameter.缺少参数NetflowVersion。
400MissingParam.ProjectNameSpecify the ProjectName parameter.缺少参数ProjectName。
400MissingParam.SlsRegionIdSpecify the SlsRegionId parameter.缺少参数SlsRegionId。
400IllegalParam.ActiveAgingThe specified ActiveAging is invalid.参数ActiveAging不合法。
400IllegalParam.InactiveAgingThe specified InactiveAging is invalid.参数InactiveAging不合法。
400IllegalParam.NetflowServerIpThe specified NetflowServerIp is invalid.参数NetflowServerIp不合法。
400IllegalParam.NetflowServerPortThe specified NetflowServerPort is invalid.参数NetflowServerPort不合法。
400IllegalParam.NetflowVersionThe specified NetflowVersion is invalid.参数NetflowVersion不合法。
400IllegalParam.OutputTypeThe specified OutputType is invalid.参数OutputType不合法。
400IllegalParam.RegionIdThe specified RegionId is invalid.参数RegionId不合法。
400IllegalParam.SlsRegionIdThe specified SlsRegionId is invalid.参数SlsRegionId不合法。
400IllegalParam.StatusThe specified Status parameter is invalid.参数Status不合法。
403FeatureNotSupportThe current edition of the smart access gateway does not support this feature.智能接入网关当前版本不支持该功能特性。

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