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

Cria uma sessão de espelhamento de tráfego.

Descrição da operação

A interface CreateTrafficMirrorSession é assíncrona, ou seja, o sistema retorna um ID de instância, mas a sessão de espelhamento ainda não foi criada com sucesso, e a tarefa de criação em segundo plano ainda está em andamento. Você pode chamar ListTrafficMirrorSessions para consultar o status de criação da sessão de espelhamento:

Quando a sessão de espelhamento está no estado Creating, indica que a sessão de espelhamento está sendo criada.
Quando a sessão de espelhamento está no estado Created, indica que a criação da sessão de espelhamento foi concluída.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TrafficMirrorSessionDescription	string	Não	A descrição da sessão de espelhamento de tráfego. A descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.	This is a trafficmirrorsession.
TrafficMirrorSessionName	string	Não	O nome da sessão de espelhamento de tráfego. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.	test
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que o valor seja único entre todas as solicitações. O token do cliente pode conter apenas caracteres ASCII. Nota Se você não definir este parâmetro, o sistema usará RequestId como ClientToken. O RequestId pode ser diferente para cada solicitação de API.	0c593ea1-3bea-11e9-b96b-88e9fe63****
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run. Valores válidos: true: realiza apenas um dry run. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado. false (padrão): realiza um dry run e envia a solicitação. Se a solicitação passar no dry run, a operação será executada.	false
TrafficMirrorTargetId	string	Sim	O ID do destino de espelhamento de tráfego. Você pode especificar apenas uma interface de rede elástica (ENI) ou uma instância Server Load Balancer (SLB) como destino de espelhamento de tráfego.	eni-j6c8znm5l1yt4sox****
TrafficMirrorTargetType	string	Sim	O tipo do destino de espelhamento de tráfego. Valores válidos: NetworkInterface: uma ENI SLB: uma instância SLB	NetworkInterface
TrafficMirrorFilterId	string	Sim	O ID do filtro.	tmf-j6cmls82xnc86vtpe****
VirtualNetworkId	integer	Não	O identificador de rede VXLAN (VNI). Valores válidos: 0 a 16777215. Você pode usar VNIs para identificar o tráfego espelhado de diferentes sessões no destino de espelhamento de tráfego. Você pode especificar um VNI personalizado ou usar um VNI aleatório alocado pelo sistema. Se desejar que o sistema aloque aleatoriamente um VNI, não insira um valor.	1
Priority	integer	Sim	A prioridade da sessão de espelhamento de tráfego. Valores válidos: 1 a 32766. Um valor menor indica uma prioridade mais alta. Você não pode especificar prioridades idênticas para sessões de espelhamento de tráfego criadas na mesma região usando a mesma conta.	1
Enabled	boolean	Não	Especifica se a sessão de espelhamento de tráfego deve ser ativada. Valores válidos: false (padrão): não ativa a sessão de espelhamento de tráfego. true: ativa a sessão de espelhamento de tráfego.	false
PacketLength	integer	Não	A unidade máxima de transmissão. Valores válidos: 64 a 9600. Valor padrão: 1500.	1500
TrafficMirrorSourceIds	array	Sim	O ID da origem de espelhamento de tráfego. Você pode especificar apenas uma interface de rede elástica (ENI) como origem de espelhamento de tráfego. O valor padrão de N é 1, o que indica que você pode adicionar apenas uma origem de espelhamento de tráfego a uma sessão de espelhamento de tráfego.	eni-j6c2fp57q8rr47rp****
	string	Não	O ID da origem de espelhamento de tráfego. Você pode especificar apenas uma ENI como origem de espelhamento de tráfego. O valor padrão de N é 1, o que significa que você pode adicionar apenas uma origem de espelhamento de tráfego a uma sessão de espelhamento de tráfego.	eni-j6c2fp57q8rr47rp****
RegionId	string	Sim	O ID da região à qual a sessão de espelhamento de tráfego pertence. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. Para mais informações sobre regiões que suportam espelhamento de tráfego, consulte Visão geral do espelhamento de tráfego.	cn-hongkong
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o tráfego espelhado pertence.	rg-bp67acfmxazb4ph****
Tag	array<object>	Não	A tag do recurso.
	object	Não	A tag do recurso.
Key	string	Não	A chave da tag. Você pode especificar no máximo 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:`, e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag. Você pode especificar no máximo 20 valores de tag. O valor da tag pode ser uma string vazia. 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://`.	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TrafficMirrorSessionId	string	O ID da sessão de espelhamento de tráfego.	tms-j6ce5di4w7nvigfjz****
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
ResourceGroupId	string	O ID do grupo de recursos ao qual o tráfego espelhado pertence.	rg-bp67acfmxazb4ph****

Exemplos

Resposta de sucesso

JSON formato

{
  "TrafficMirrorSessionId": "tms-j6ce5di4w7nvigfjz****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "ResourceGroupId": "rg-bp67acfmxazb4ph****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncorrectBusinessStatus.TrafficMirror	The business status of traffic mirror is incorrect.	Traffic mirroring is in an invalid state.
400	OptInRequired.TrafficMirror	You need to subscribe to the traffic mirror service first.	Traffic mirroring is disabled.
400	DuplicatedParam.SourceInstanceIds	The parameter of source instance IDs contains duplicate values.	Duplicate values are set for TrafficMirrorSourceIds.N.
400	OperationDenied.DuplicateRole	The network interface must not be the source and the target of traffic mirror sessions at the same time.
400	ResourceNotFound.NetworkInterface	The specified resource of %s is not found.	The error message returned because NetworkInterface is set to an invalid value.
400	ResourceNotFound.EcsInstance	The specified resource of ECS instance is not found.
400	ResourceNotFound.Slb	The specified resource of SLB is not found.
400	OperationDenied.SlbNotInVpc	The specified SLB is not in any VPC.
400	ResourceNotFound.TrafficMirrorFilter	The specified resource of traffic mirror filter is not found.	The specified filter does not exist.
400	IncorrectStatus.TrafficMirrorFilter	The status of traffic mirror filter is incorrect.	The filter is in an invalid state.
400	OperationDenied.EcsNotSupportTrafficMirror	The ECS instance does not support traffic mirroring.
400	QuotaExceeded.SessionNum	The quota of the number of traffic mirror sessions is exceeded.	The number of traffic mirror sessions has reached the upper limit.
400	QuotaExceeded.FilterRelatedSession	The quota of the number of traffic mirror sessions related to one filter is exceeded.	The number of traffic mirror sessions associated with the filter has reached the upper limit.
400	QuotaExceeded.SourceNumPerSession	The quota of the number of traffic mirror sources per session is exceeded.	The number of traffic mirror sources associated with a traffic mirror session has reached the upper limit.
400	QuotaExceeded.NetworkInterfaceRelatedSession	The quota of the number of traffic mirror sessions related to one network interface is exceeded.	The number of traffic mirror sessions associated with an ENI has reached the upper limit.
400	QuotaExceeded.SlbRelatedSession	The quota of the number of traffic mirror sessions related to one SLB is exceeded.	The number of traffic mirror sessions associated with an SLB instance has reached the upper limit.
400	UnsupportedRegion	The feature is not supported in current region.	The feature is not supported in the current region.
400	InvalidLoadBalancerId.NotFound	The specified resource of load balancer is not found.	The SLB instance does not exist.
400	OperationDenied.FreeNetworkInterface	The network interface is not attached to any ECS instance.	The ENI is not associated with an ECS instance.
400	OperationDenied.ClassicSLB	The operation is not allowed because of ClassicSLB.	The error message returned because you cannot perform the operation on a CLB instance.
400	ResourceNotFound.TargetInstance	The specified target instance for traffic mirroring is not found.	The specified traffic mirror destination does not exist.
400	QuotaExceeded.SourceNumPerTarget	The maximum number of traffic mirror sources for a target is exceeded.	The number of traffic mirror sources associated with the image exceeds the upper limit.
400	IncorrectStatus.NetworkInterface	The status of network interface is incorrect.	The status of the ENI is invalid.
400	OperationFailed.NotSupportBizType	The specified instance type does not support the operation.	The specified instance type does not support the operation.
400	IllegalParam.Priority	The specified Priority is illegal or the same as other mirroring sessions.	The specified Priority is illegal or identical to another mirroring session
400	OperationDenied.UnsupportedTargetType	Traffic mirror target must be SLB if traffic mirror sources contain nat gateway network interface.	When a NAT gateway NIC exists in the traffic mirroring source, the traffic mirroring purpose must be SLB type.
400	OperationDenied.TargetTypeNotSupportGatewayLoadBalancerEndpoint	Operation denied because of target type can not be GatewayLoadBalancerEndpoint.	Gateway-based load balancing endpoints are not supported as traffic mirrors mu d
400	OperationDenied.TargetTypeNotSupportBondEni	Operation denied because of target type can not be Bond Network Interface.	Operation denied because of target type can not be Bond Network Interface.
400	OperationDenied.InvalidTargetBondEniType	The traffic mirroring target does not support the entered bond ENI type.	The traffic mirroring target does not support the entered bond ENI type.
400	OperationDenied.InvalidSourceBondEniType	The traffic mirroring source does not support the entered bond ENI type.	The traffic mirroring source does not support the entered bond ENI type.
400	OperationDenied.TargetTypeNotSupportTrafficMirrorFullPacket	The traffic mirror session target type does not support the feature of mirroring source full packet.	The traffic mirror session target type does not support the feature of mirroring source full packet
400	OperationDenied.TrafficMirrorSessionSourceFullPacketNotSupport	The traffic mirror session does not support the feature of mirroring source full packet.	Traffic mirror currently does not support source full packet mirroring. TrafficMirrorSourceTruncateMode can only be set to 0, which is the default mode.
400	QuotaExceeded.SessionNumPerTarget	The quota of the number of traffic mirror sessions per target is exceeded.
400	OperationDenied.NotSupportBondEniAsTrafficMirrorSource	The operation is not allowed because bond eni cannot be the source of traffic mirror.	Bond eni is not allowed to be the source of traffic mirror.
400	IncorrectStatus.TrafficMirrorSessionTarget	The status of the target of the traffic mirror session is incorrect.	The status of the intent of the traffic mirroring session is incorrect.
404	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance not found.	GatewayLoadBalancerEndpoint instance not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.