CreateNetworkPath - Network Intelligence Service - Centro de documentación de Alibaba Cloud

Crea una ruta de red para el análisis de accesibilidad.

Descripción de la operación

Puede llamar a la operación CreateNetworkPath para crear rutas de red en múltiples escenarios de red y entre múltiples recursos. Una vez creada una ruta, los parámetros de la ruta se guardan para realizar análisis repetidos.
Puede crear hasta 100 rutas de red dentro de una cuenta de Alibaba Cloud.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

nis:CreateNetworkPath

create

*NetworkPath

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	No	El ID de la región de la ruta de red que desea crear.	cn-hangzhou
NetworkPathName	string	Sí	El nombre de la ruta de red.	ecs2PublicIp
SourceId	string	Sí	El ID del recurso de origen.	i-2zef4ngqfarepyun****
SourceType	string	Sí	El tipo de recurso de origen. Valores válidos: ecs: la instancia de Elastic Compute Service (ECS) internetIp: la dirección IP pública vsw: el vSwitch vpn: la puerta de enlace VPN vbr: el virtual border router (VBR)	ecs
SourceIpAddress	string	No	La dirección IP de origen.	172.17.XX.XX
SourcePort	integer	No	El puerto de origen.	443
TargetId	string	No	El ID del recurso de destino.	i-bp13d0e064gubm****
TargetType	string	No	El tipo de recurso de destino. Valores válidos: ecs: la instancia de ECS internetIp: la dirección IP pública vsw: el vSwitch vpn: la puerta de enlace VPN vbr: el VBR clb: la instancia de Classic Load Balancer (CLB)	ecs
TargetIpAddress	string	No	La dirección IP de destino.	192.168.XX.XX
TargetPort	integer	No	El puerto de destino.	80
Protocol	string	No	El 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	No	La descripción de la ruta de red.	分析ECS到ECS路径
Tag	array<object>	No	Las etiquetas que se agregarán al recurso.
	object	No
Key	string	No	La clave de la etiqueta N que se agregará al recurso. La clave de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. La clave de la etiqueta no puede comenzar con `acs:` ni `aliyun`. Puede agregar hasta 20 etiquetas en cada llamada.	role
Value	string	No	El valor de la etiqueta N que se agregará al recurso. Puede especificar hasta 20 valores de etiqueta. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. El valor de la etiqueta no puede comenzar con `aliyun` ni `acs:`.	ops
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-acfm27qsxjj****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
NetworkPathId	string	El ID de la ruta de red.	np-4cbf598673d14d27****
RequestId	string	El ID de la solicitud.	92DD9FFB-06FB-56F7-83EF-5CEF98F5562A

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.