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

Crea una tarea para analizar la alcanzabilidad de la red.

Descripción de la operación

La operación CreateNetworkReachableAnalysis se utiliza para crear una tarea que analiza la alcanzabilidad de la ruta de red creada mediante la operación CreateNetworkPath y registra los resultados del análisis.
La operación CreateNetworkReachableAnalysis se puede invocar para analizar repetidamente la alcanzabilidad de una ruta de red.
Puede crear hasta 1,000 registros de análisis de alcanzabilidad 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:CreateNetworkReachableAnalysis

create

*NetworkReachableAnalysis

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	No	El ID de la región para la que desea crear una tarea de análisis de alcanzabilidad de la red.	cn-shanghai
NetworkPathId	string	Sí	El ID de la ruta de red. Puede invocar la operación CreateNetworkPath para obtener el ID de la ruta de red.	np-b2f618ceb2c84057****
Tag	array<object>	No	Las etiquetas que se agregarán al recurso.
	object	No	La información de la etiqueta.
Key	string	No	La clave de la etiqueta 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.	Team
Value	string	No	El valor de la etiqueta que se agregará al recurso. 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 `acs:` ni `aliyun`. El valor de la etiqueta puede ser una cadena vacía. Puede agregar hasta 20 valores de etiqueta en cada llamada.	ops

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
NetworkReachableAnalysisId	string	El ID de la tarea de análisis de alcanzabilidad de la red.	nra-2fede05617494417****
RequestId	string	El ID de la solicitud.	A7F0D6EC-E19E-58AC-AC9F-08036763960F

Ejemplos

Respuesta exitosa

JSON Formato

{
  "NetworkReachableAnalysisId": "nra-2fede05617494417****",
  "RequestId": "A7F0D6EC-E19E-58AC-AC9F-08036763960F"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	IncorrectStatus.NetworkPath	The last analysis status of %s is %s. Please try again later.	The Reachability Analyzer task %s is not completed. Try again after the task is completed.
400	QuotaExceeded.ParallelNraLimit	The maximum number of parallel reachability analysis task is exceeded.	The number of parallel Reachability Analyzer tasks exceeds the upper limit.
400	QuotaExceeded.MaxNraCount	The maximum number of reachability analysis task is exceeded.	The number of saved Reachability Analyzer tasks exceeds the upper limit.
400	IllegalParam.ZoneId	The specified available zone (%s) is invalid.	The specified zone (%s) is invalid.
400	IllegalParam.StepMinutes	The specified sampling interval (%s) is invalid.	The specified sampling interval (%s) is invalid.
400	IllegalParam.BeginTime	The specified begin time (%s) is invalid.	The specified start time (%s) is invalid.
400	IllegalParam.EndTime	The specified end time (%s) is invalid.	The specified end time (%s) is invalid.
400	Mismatch.BeginTimeAndEndTime	The specified begin time must be earlier than the end time.	The specified start time must be earlier than the end time.
400	MissingParameter.TagValue	You must specify Tag.N.Value.
400	NumberExceed.Tags	The maximum number of Tags is exceeded.
400	MissingParameter.TagKey	You must specify Tag.N.Key.
400	Duplicate.TagKey	The Tag.N.Key contains duplicate keys.
400	InvalidParameter.TagKey	The Tag.N.Key parameter is invalid.
400	InvalidParameter.TagValue	The Tag.N.Value parameter is invalid.
404	ResourceNotFound.NetworkPath	The specified resource of %s is not found.

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.