CreateNetworkPath - Network Intelligence Service: Central de Documentação do Alibaba Cloud

Cria um caminho de rede para análise de alcançabilidade.

Descrição da operação

Você pode chamar a operação CreateNetworkPath para criar caminhos de rede em vários cenários de rede e entre vários recursos. Após a criação de um caminho, os parâmetros do caminho são salvos para análises repetidas.
Você pode criar até 100 caminhos de rede em uma conta da Alibaba Cloud.

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

nis:CreateNetworkPath

create

*NetworkPath

acs:nis:*:{#accountId}:networkpath/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região do caminho de rede que você deseja criar.	cn-hangzhou
NetworkPathName	string	Sim	O nome do caminho de rede.	ecs2PublicIp
SourceId	string	Sim	O ID do recurso de origem.	i-2zef4ngqfarepyun****
SourceType	string	Sim	O tipo do recurso de origem. Valores válidos: ecs: a instância do Elastic Compute Service (ECS) internetIp: o endereço IP público vsw: o vSwitch vpn: o gateway de VPN vbr: o roteador de borda virtual (VBR)	ecs
SourceIpAddress	string	Não	O endereço IP de origem.	172.17.XX.XX
SourcePort	integer	Não	A porta de origem.	443
TargetId	string	Não	O ID do recurso de destino.	i-bp13d0e064gubm****
TargetType	string	Não	O tipo do recurso de destino. Valores válidos: ecs: a instância ECS internetIp: o endereço IP público vsw: o vSwitch vpn: o gateway de VPN vbr: o VBR clb: a instância do Classic Load Balancer (CLB)	ecs
TargetIpAddress	string	Não	O endereço IP de destino.	192.168.XX.XX
TargetPort	integer	Não	A porta de destino.	80
Protocol	string	Não	O tipo de protocolo. Valores válidos: tcp: Transmission Control Protocol (TCP) udp: User Datagram Protocol (UDP) icmp: Internet Control Message Protocol (ICMP)	tcp
NetworkPathDescription	string	Não	A descrição do caminho de rede.	Analysis ECS to ECS path
Tag	array<object>	Não	As tags a serem adicionadas ao recurso.
	object	Não
Key	string	Não	A chave da tag N a ser adicionada ao recurso. A chave da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`. A chave da tag não pode começar com `acs:` ou `aliyun`. Você pode adicionar até 20 tags em cada chamada.	role
Value	string	Não	O valor da tag N a ser adicionada ao recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`. O valor da tag não pode começar com `aliyun` ou `acs:`.	ops
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-acfm27qsxjj****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
NetworkPathId	string	O ID do caminho de rede.	np-4cbf598673d14d27****
RequestId	string	O ID da solicitação.	92DD9FFB-06FB-56F7-83EF-5CEF98F5562A

Exemplos

Resposta de sucesso

JSON formato

{
  "NetworkPathId": "np-4cbf598673d14d27****",
  "RequestId": "92DD9FFB-06FB-56F7-83EF-5CEF98F5562A"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.InternetIP	The specified IP address (%s) is not an internet IP address.	The specified IP address (%s) is not a public IP address. The IP address must not fall within the following ranges: 10.0.0.0 to 10.255.255.255, 172.16.0.0 to 172.31.255.255, or 192.168.0.0 to 192.168.255.255.
400	IllegalParam.IP	The specified IP address (%s) is invalid.	The specified IP address (%s) is invalid.
400	QuotaExceeded.NetworkPath	The quota of %s is exceeded, usage %s/%s.	The specified number of network paths exceeds the upper limit. Usage: %s/%s.
400	ResourceAlreadyExist.NetworkPath	The specified resource of %s already exists.	The specified network path configuration %s already exists.
400	Mismatch.SourceIdAndTargetId	Reachability Analyzer does not support the scenario in which source and target Internet IP addresses and ECS instance ID (%s and %s) are bound.	Reachability Analyzer does not support the scenario in which the public IP addresses of the source and destination are associated with the ECS instance (%s and %s).
400	IllegalParam.SourceAndTargetInternetIp	Both source ID and target ID are IP addresses, but are not Internet IP addresses. Reachability Analyzer does not support the scenario.	Both the source and destination are IP addresses, but not Alibaba Cloud public IP addresses. Reachability Analyzer supports only Alibaba Cloud public IP addresses.
400	IllegalParam.SourcePort	The specified SourcePort(%s) value is invalid. The value must be within the range of (0,65536].	The value of SourcePort is invalid. Valid values: 0 to 65536.
400	IllegalParam.TargetPort	The specified TargetPort(%s) value is invalid. The value must be within the range of (0,65536].	The value of TargetPort is invalid. Valid values: 0 to 65536.
400	IllegalParam.SourceId	The specified SourceId(%s) may be not exist.	The specified instance (%s) may not exist. Check the spelling.
400	IllegalParam.TargetId	The specified TargetId(%s) may be not exist.	The specified instance (%s) may not exist. Check the spelling.
400	MissingParameter.TagValue	You must specify Tag.N.Value.
400	NumberExceed.Tags	The maximum number of Tags is exceeded.
400	Duplicate.TagKey	The Tag.N.Key contains duplicate keys.
400	MissingParameter.TagKey	You must specify Tag.N.Key.
400	InvalidParameter.TagKey	The Tag.N.Key parameter is invalid.
400	InvalidParameter.TagValue	The Tag.N.Value parameter is invalid.
400	IllegalParam.SourceIp	Please enter a valid source IP.	Please enter a valid source IP
400	IllegalParam.Protocol	The specified Protocol(%s) is invalid.	The Protocol(%s) parameter is invalid.
400	IllegalParam.TargetType	The specified target type (%s) is invalid.	The specified destination type () is invalid.
400	IllegalParam.SourceType	The specified source type (%s) is invalid.
400	IllegalParam.TargetIp	The specified target ip (%s) is invalid.	The specified destination IP() is not in the correct format.
400	IllegalParam.NotSupportHaVpn	The specified VPN(%s), which is not currently supported for such instances.	The specified VPN(), which is not currently supported for such instances.
400	IllegalParam.SourceNotBound	Elastic public network IP(%s) is not bound to resources, and analysis is not supported for the time being.	Elastic public network IP() is not bound to resources, and analysis is not supported for the time being.
400	IllegalParam.TargetNotBound	Elastic public network IP(%s) is not bound to resources, and analysis is not supported for the time being.
400	IllegalParam.NotPublicIp	The specified (%s) is invalid.	The specified parameter is illegal.
400	IllegalParam.SourceEqualTarget	The specified source and destination are identical, which is not supported for analysis.	The specified source and destination are the same, and analysis is not supported.
400	IllegalParam.TypeAndIdMismatch	The specified instanceId (%s) and type do not match.	The specified instanceId and its type do not match.
403	Forbidden.NetworkPath	The current user has not activated NIS and is not authorized to use the path analysis interface.	The current user has not activated NIS and is not authorized to use the path analysis interface.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.