CreateFlowLog - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Cria um log de fluxo.

Descrição da operação

CreateFlowLog é uma operação assíncrona. Após chamar esta operação, o sistema retorna um ID de instância, mas o log de fluxo ainda não foi criado. A tarefa de criação ainda está sendo executada em segundo plano. Você pode chamar DescribeFlowLogs para consultar o status de criação do log de fluxo:\n- Se o log de fluxo estiver no estado Activating, o log de fluxo está sendo criado.\n- Se o log de fluxo estiver no estado Active, o log de fluxo foi criado e ativado.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:CreateFlowLog

create

VSwitch.

acs:vpc:{#regionid}:{#accountId}:vswitch/{#VSwitchId}

*FlowLog.

acs:vpc:{#regionId}:{#accountId}:flowlog/*

VPC.

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do log de fluxo. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-qingdao
FlowLogName	string	Não	O nome do log de fluxo.\n\nO nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.	myFlowlog
Description	string	Não	A descrição do log de fluxo.\n\nA descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.	Este é o meu log de fluxo
ResourceType	string	Sim	O tipo do recurso cujo tráfego você deseja capturar. Valores válidos:\n\n- NetworkInterface: interfaces de rede (NICs).\n \n- VSwitch: todas as interfaces de rede (NICs) em um vSwitch.\n \n- VPC: todas as interfaces de rede (NICs) em uma nuvem privada virtual (VPC).	NetworkInterface
ResourceId	string	Sim	O ID do recurso cujo tráfego você deseja capturar.	eni-askldfas****
TrafficType	string	Sim	O tipo de tráfego a ser coletado. Valores válidos:\n\n- All: todo o tráfego.\n \n- Allow: tráfego permitido pelo controle de acesso.\n \n- Drop: tráfego negado pelo controle de acesso.	All
ProjectName	string	Não	O nome do projeto que gerencia o tráfego capturado.\n- O nome do projeto pode conter apenas letras minúsculas, dígitos e hifens (-).\n- O nome deve começar e terminar com uma letra minúscula ou dígito.\n- O nome deve ter de 3 a 63 caracteres.	FlowLogProject
LogStoreName	string	Não	O nome do Logstore que armazena o tráfego capturado.\n- O nome do Logstore pode conter apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_).\n- O nome deve começar e terminar com uma letra minúscula ou dígito.\n- O nome deve ter de 3 a 63 caracteres.	FlowLogStore
AggregationInterval	integer	Não	O intervalo de amostragem do log de fluxo. Unidade: minutos. Valores válidos: 1, 5 e 10 (padrão).	10
TrafficPath	array	Não	O caminho de tráfego a ser coletado. Valores válidos:\n\n- all (padrão): todos os cenários.\n- internetGateway: tráfego para acessar a Internet.\n- natGateway: tráfego através do NAT gateway.\n- vpnGateway: tráfego através do VPN gateway.\n- transitRouter: tráfego através do TR.\n- gatewayEndpoint: tráfego através do endpoint de gateway para acessar os serviços da Alibaba Cloud.\n- vbr: tráfego através do Virtual Border Router (VBR) para acessar circuitos do Express Connect.\n- ecr: tráfego através do Express Connect Router (ECR).\n- ipv4Gateway: tráfego através do gateway IPv4 para acessar a Internet.\n- gatewayLoadBalancerEndpoint: tráfego através do endpoint do Gateway Load Balancer (GWLBe).
	string	Não	O caminho de tráfego a ser coletado. Valores válidos:\n\n- all (padrão): todos os cenários.\n- internetGateway: tráfego para acessar a Internet.\n- natGateway: tráfego através do NAT gateway.\n- vpnGateway: tráfego através do VPN gateway.\n- transitRouter: tráfego através do TR.\n- gatewayEndpoint: tráfego através do endpoint de gateway para acessar os serviços da Alibaba Cloud.\n- vbr: tráfego através do Virtual Border Router (VBR) para acessar circuitos do Express Connect.\n- ecr: tráfego através do Express Connect Router (ECR).\n- ipv4Gateway: tráfego através do gateway IPv4 para acessar a Internet.\n- gatewayLoadBalancerEndpoint: tráfego através do endpoint do Gateway Load Balancer (GWLBe).	all
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-acfmxazdjdhd****
Tag	array<object>	Não	As tags do recurso.
	object	Não	A tag.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. Não especifique uma string vazia para este parâmetro.\n\nUma chave de tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag do recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia.\n\nO valor da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	FinanceJoshua
IpVersion	string	Não	A versão do IP do tráfego capturado pelo log de fluxo.	IPv4
LogFormat	string	Não

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da solicitação.
RequestId	string	O ID da solicitação.	54B48E3D-DF70-471B-AA93-08E683A1B457
Success	string	Indica se a chamada foi bem-sucedida. Valores válidos:\n\n- true: A chamada foi bem-sucedida.\n- false: A chamada falhou.	true
FlowLogId	string	O ID do log de fluxo.	fl-m5e8vhz2t21sel1nq****
ResourceGroupId	string	O ID do grupo de recursos.	rg-acfmxazdjdhd****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncorrectBusinessStatus.FlowLog	The business status of flowLog is incorrect.	O status atual do serviço não oferece suporte à criação de instâncias de log de fluxo.
400	OptInRequired.FlowLog	You are not authorized to use the requested service of flowLog. Ensure that you have subscribed to the service you are trying to use.	Você não está autorizado a usar o serviço flowLog solicitado. Certifique-se de ter ativado o serviço que está tentando usar.
400	OperationUnsupported.AdvancedFeature	Advanced features of the vpc is unsupported.	O recurso avançado não é suportado.
400	InvalidInstanceId	vswitch does not exist.	A instância vSwitch não existe.
400	ProjectOrLogstoreNotExist	The specified project or logstore does not exist.	O projeto ou Logstore especificado não existe.
400	SourceProjectNotExist	The Source Project or logstore does not exist.	O projeto de origem ou o Logstore do Simple Log Service não existe.
400	Unauthorized	This api does not support sub user or role.	Esta operação de API não oferece suporte a usuários ou funções do RAM.
400	OperationUnsupported.action	This action is not support.	Esta operação não é suportada.
400	ParameterInvalid	Invalid parameter.	O parâmetro de entrada é inválido.
400	RuleExist	The rule has already existed.
400	InvalidHdMonitorStatus	Current instance status is not valid for this action.
400	QuotaExceeded.FlowlogCount	This user has reached the maximum instance number of flowlog.	O número máximo de instâncias de log de fluxo foi atingido.
400	InvalidResourceId.NotFound	This resourceId already has flowlog instance existed.	Já existe uma instância de log de fluxo para o recurso especificado.
400	INVALID_PARAMETER	The parameter invalid.
400	MissingParameter	Missing mandatory parameter
400	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	O RegionId especificado não existe. Verifique se este produto está disponível na região especificada.
400	InvalidResourceType.NotFound	Resource type no the same.
400	OperationUnsupported.ResourceType	This resource type is not supported.
400	IllegalParam.AggregationInterval	The param of aggregationInterval is illegal.	O parâmetro de intervalo de amostragem é inválido.
400	UnsupportedFeature.UserDefinedTrafficPath	The feature of UserDefinedTrafficPath is not supported.	O recurso trafficPath de log de fluxo personalizado não é suportado para este usuário.
400	IllegalParam.TrafficPath	The param of trafficPath is illegal.	O parâmetro trafficPath especificado é inválido.
400	DuplicatedParam.TrafficPath	The param of trafficPath is duplicated.	O parâmetro trafficPath especificado contém valores duplicados.
400	IllegalParam.ResourceGroupId	Invalid ResourceGroupld value.	O grupo de recursos especificado é inválido ou não existe.
400	OperationDenied.OperateShareResource	The operation is not allowed because of OperateShareResource.	A operação falhou porque envolve um recurso compartilhado.
400	UnsupportedFeature.IpVersion	The ipversion type is not supported.	O valor ipVersion especificado não é suportado.
400	UnsupportedFeature.VpcAdvancedFeature	The VPC does not support some advanced features.	A VPC à qual o vSwitch especificado pertence não oferece suporte a recursos avançados. Use um vSwitch diferente e tente novamente.
400	OperationFailed.EniTypeNotSupport	Operation failed because the ENI type is not supported.	O tipo da ENI secundária não suporta esta operação.
400	IllegalParam.IpVersion	The parameter of IpVersion is illegal.
400	OperationDenied.NisTrafficAnalyzerAggregationIntervalMismatch	The sampling interval of the FlowLog is greater than the sampling interval of the NIS Traffic Analyzer.	O intervalo de amostragem do log de fluxo é maior que o intervalo de amostragem do NIS Traffic Analyzer.
400	OperationDenied.NisTrafficAnalyzerNotFound	The specified NIS Traffic Analyzer does not exist.	O NIS Traffic Analyzer especificado não existe.
400	OperationDenied.NisTrafficAnalyzerNotActive	The specified NIS Traffic Analyzer is not enabled.	O NIS Traffic Analyzer especificado não está no estado ativado.
400	OperationFailed.InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro desconhecido. Tente repetir a operação. Se o erro persistir, abra um ticket.
400	MissingParam.TrafficAnalyzerIdOrLogProjectOrLogStore	TrafficAnalyzerId and ProjectName and LogStoreName parameters are not passed in.	Nem o parâmetro TrafficAnalyzerId nem os parâmetros ProjectName e LogStoreName foram fornecidos.
400	OperationDenied.AllTrafficPathOfManagedExist	The resource you specified has created a flow log instance that collects the traffic of all scenarios. You cannot create a flow log instance that collects only some scenarios.	Uma instância de flow log que coleta tráfego para todos os cenários já foi criada para o recurso especificado. Não é possível criar outra instância de flow log que colete tráfego apenas para alguns cenários.
400	UnsupportedFeature.UserDefinedTrafficPathIpv6	Dual-stack flow log instances do not support custom trafficPath.	As instâncias de log de fluxo de pilha dupla não suportam o recurso trafficPath personalizado.
400	IllegalParam.LogFormat	The specified parameter of LogFormat is invalid.	O parâmetro LogFormat especificado é inválido.
400	OperationDenied.UnsupportedField	LogFormat contains unsupported fields.	O LogFormat contém campos não suportados.
400	UnsupportedFeature.LogFormat	The ability to customize subscription fields for flow logs is not yet available, so stay tuned.	O recurso de campo de assinatura personalizado para logs de fluxo ainda não está disponível.
400	UnsupportedFeature.LogFormatNisTrafficAnalyze	The flow log for which NIS traffic analysis is enabled does not support custom subscription fields.	Os logs de fluxo com o NIS Traffic Analyzer ativado não oferecem suporte a campos de assinatura personalizados.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.