CreateFlowlog - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Cria um log de fluxo.

Descrição da operação

Os logs de fluxo ajudam você a capturar informações de tráfego transmitidas por instâncias de roteador de trânsito e conexões de instância de rede (conexões inter-regionais, conexões VPC, conexões VPN, conexões ECR e conexões VBR). Antes de criar um log de fluxo, observe os seguintes itens:

Somente os roteadores de trânsito da Enterprise Edition suportam logs de fluxo.
Para conexões inter-regionais, os logs de fluxo capturam apenas o tráfego de saída do roteador de trânsito e não capturam o tráfego de entrada para o roteador de trânsito.

Por exemplo, se uma instância do Elastic Compute Service (ECS) na região US (Silicon Valley) acessar uma instância do ECS na região US (Virginia) através da Cloud Enterprise Network (CEN), após configurar um log de fluxo para o roteador de trânsito na região US (Virginia), você poderá visualizar as informações de pacotes que a instância do ECS na região US (Virginia) envia para a instância do ECS na região US (Silicon Valley) no console do Simple Log Service. No entanto, você não poderá visualizar as informações de pacotes que a instância do ECS na região US (Silicon Valley) envia para a instância do ECS na região US (Virginia). Para visualizar as informações de pacotes que a instância do ECS na região US (Silicon Valley) envia para a instância do ECS na região US (Virginia), você também deve configurar um log de fluxo para o roteador de trânsito na região US (Silicon Valley).
Quando um log de fluxo captura informações de tráfego para uma conexão VPC, ele captura apenas o tráfego transmitido pelas interfaces de rede elásticas (ENIs) do roteador de trânsito. Para visualizar o tráfego transmitido por outras ENIs na VPC, consulte Visão geral dos logs de fluxo da VPC.
A operação CreateFlowlog é assíncrona. O sistema primeiro retorna um ID de log de fluxo, mas o log de fluxo ainda não foi criado. A tarefa de criação continua sendo executada em segundo plano. Você pode chamar a operação DescribeFlowlogs para consultar o status do log de fluxo.
- Se o log de fluxo estiver no estado Creating, o log de fluxo está sendo criado. Nesse estado, você pode realizar apenas operações de consulta.
- Se o log de fluxo estiver no estado Active, o log de fluxo foi criado.

Antes de começar

Antes de criar um log de fluxo para um recurso, certifique-se de ter os recursos relevantes. Para mais informações sobre como criar cada recurso, consulte:

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

cen:CreateFlowlog

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode gerar um valor de parâmetro em seu cliente para garantir que o valor seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o token de cliente. O RequestId de cada solicitação de API pode ser diferente.	123e4567-e89b-12d3-a456-42665544****
RegionId	string	Sim	O ID da região do log de fluxo. Você pode chamar a operação DescribeChildInstanceRegions para consultar o ID da região.	cn-hangzhou
FlowLogName	string	Não	O nome do log de fluxo. O nome pode estar vazio ou ter de 1 a 128 caracteres. Não pode começar com http:// ou https://.	myFlowlog
Description	string	Não	A descrição do log de fluxo. A descrição pode estar vazia ou ter de 1 a 256 caracteres. Não pode começar com http:// ou https://.	myFlowlog
CenId	string	Sim	O ID da instância da Cloud Enterprise Network (CEN).	cen-7qthudw0ll6jmc****
ProjectName	string	Não	O projeto usado para armazenar o tráfego capturado. Se você já criou um projeto na região atual, pode inserir o nome do projeto existente. Se você não criou um projeto na região atual, pode especificar um nome personalizado para o projeto, e o sistema criará o projeto automaticamente. O nome do projeto deve ser globalmente exclusivo em uma região do Alibaba Cloud e não pode ser modificado após a criação. As regras de nomenclatura são as seguintes: O nome do projeto deve ser globalmente exclusivo. O nome pode conter apenas letras minúsculas, dígitos e hifens (-). O nome deve começar e terminar com uma letra minúscula ou um dígito. O nome deve ter de 3 a 63 caracteres.	flowlog-project
LogStoreName	string	Não	O Logstore usado para armazenar o tráfego capturado. Se você já criou um Logstore na região atual, pode inserir o nome do Logstore existente. Se você não criou um Logstore na região atual, pode especificar um nome personalizado para o Logstore, e o sistema criará o Logstore automaticamente. As regras de nomenclatura para o nome do Logstore são as seguintes: O nome do Logstore deve ser exclusivo no mesmo projeto. O nome pode conter apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_). O nome deve começar e terminar com uma letra minúscula ou um dígito. O nome deve ter de 3 a 63 caracteres.	flowlog-logstore
Interval	integer	Não	A duração da janela de captura para o log de fluxo capturar o tráfego. Unidade: segundos. Valores válidos: 60 e 600. Valor padrão: 600.	600
TransitRouterAttachmentId	string	Não	O ID da conexão VPC, conexão VPN, conexão VBR, conexão ECR ou conexão inter-regional. Deixe este parâmetro vazio se você quiser configurar um log de fluxo para uma instância de roteador de trânsito.	tr-attach-r6g0m3epjehw57****
TransitRouterId	string	Não	O ID da instância do roteador de trânsito.	tr-bp1rmwxnk221e3fas****
LogFormatString	string	Não	A string personalizada dos campos de registro do log de fluxo. O formato é definido como: ${Field 1}${Field 2}${Field 3}...${Field n} Se você não especificar este parâmetro, todos os campos padrão serão registrados. Se você especificar este parâmetro, a string deve começar com ${srcaddr}${dstaddr}${bytes} porque ${srcaddr}${dstaddr}${bytes} é obrigatório. Para mais informações sobre todos os campos de log de fluxo suportados, consulte Configurar um log de fluxo.	${srcaddr}${dstaddr}${bytes}
Tag	array<object>	Não	As informações da tag. Você pode inserir até 20 tags por vez.
	object	Não	As informações da tag. Você pode inserir até 20 tags por vez.
Key	string	Não	A chave da tag do recurso. Este parâmetro não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://. Você pode inserir até 20 chaves de tag por vez.	TagKey
Value	string	Não	O valor da tag do recurso. Este parâmetro não pode estar vazio. O valor da tag pode ter até 128 caracteres. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://. Cada chave de tag corresponde a um valor de tag. Você pode inserir até 20 valores de tag por vez.	TagValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	54B48E3D-DF70-471B-AA93-08E683A1B457
Success	string	Indica se a chamada foi bem-sucedida. true: A chamada foi bem-sucedida. false: A chamada falhou.	true
FlowLogId	string	O ID do log de fluxo.	flowlog-m5evbtbpt****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ProjectOrLogstoreNotExist	The specified project or logstore does not exist.	O projeto ou Logstore especificado nos parâmetros não existe.
400	SourceProjectNotExist	The Source Project or logstore does not exist.	O projeto de origem ou o Logstore não existe.
400	OperationUnsupported.action	This action is not support.	A operação especificada não é suportada.
400	RuleExist	The rule has already existed.	A regra já existe.
400	QuotaExceeded.FlowlogCount	This user has reached the maximum instance number of flowlog.	O número de flow logs para este usuário atingiu o limite superior.
400	InvalidFlowlogId.exist	This cenId already has flowlog instance existed.	Já existe uma instância de log de fluxo para a instância CEN.
400	Flowlog.AlreayExist	This attachment already has existed flowlog instance.	O log de fluxo já existe e não pode ser criado novamente.
400	IllegalParam.TransitRouterAttachmentId	TransitRouterAttachmentId is illegal.	O TrInstance especificado na solicitação é inválido.
400	InvalidTransitRouterAttachmentId.NotFound	The TransitRouterAttachmentId is not found.	O ID da instância de conectividade de rede não existe.
400	IncorrectStatus.flowlog	This action is not allowed in the current flow log status.	O status do flow log é inválido.
400	InvalidOperation.TransitRouterNotExist	Operation is invalid because the transit router not exist.	O transit router não existe.
400	IncorrectStatus.TransitRouterAttachmentId	The resource is not in a valid state for the attachment operation.	O status atual do TransitRouterAttachment não suporta esta operação. Tente novamente mais tarde.
400	ProjectExist	Project already exist, please try a different project name.	O projeto de log já existe. Use um nome de projeto diferente.
400	InvalidParameter.ProjectName	Project name is invalid or does not belong to specified region.	O nome do projeto é inválido ou não pertence à região especificada.
400	IncorrectStatus.TrFlowlog	Flowlog status for specified TransitRouter is invalid for this operation.	O estado de configuração do log de fluxo do transit router especificado é inválido.
400	OperationInvalid.IncompatibleFlowlogExist	Operation is invalid because incompatible flowlog config exists.	Existe uma configuração de flow log incompatível. Exclua-a e tente novamente.
400	InvalidParameter.LogFormatString	LogFormatString is invalid.	O formato de log especificado é inválido.
400	InvalidParameter.LogStoreName	Specified LogStore name is invalid.	O nome do Logstore é inválido.
400	OperationFailed.InvalidLogInfo	The entered log service information is invalid. Check whether the ProjectName and LogStoreName are correct, and whether Log Service has been activated.	As informações especificadas do Simple Log Service são inválidas. Verifique se o ProjectName e o LogStoreName estão corretos e se o Simple Log Service está ativado.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	O transit router está em um estado inválido.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	Você não tem permissões suficientes para realizar esta operação. Abra um ticket para obter assistência.
400	InvalidParameter.CenId	The specified parameter CenId is invalid.	O parâmetro CenId especificado é inválido.
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	O parâmetro Tag Value especificado é inválido.
400	InvalidParameter.TransitRouterAttachmentId	The specified parameter TransitRouterAttachmentId is invalid.	O parâmetro TransitRouterAttachmentId especificado é inválido.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.	O parâmetro TransitRouterId especificado é inválido.
403	NoPermission.AliyunServiceRoleForTRFlowLog	You are not authorized to create service linked role AliyunServiceRoleForTRFlowLog.	Você não tem permissão para criar a função vinculada ao serviço AliyunServiceRoleForTRFlowLog.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.