DescribeVpnPbrRouteEntries - VPN Gateway - Centro de documentación de Alibaba Cloud

Consulta las rutas basadas en políticas configuradas para una instancia de VPN gateway mediante la operación DescribeVpnPbrRouteEntries.

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

vpc:DescribeVpnPbrRouteEntries

get

*VpnGateway

acs:vpc:{#regionId}:{#accountId}:vpngateway/{#VpnGatewayId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de región de la instancia de VPN gateway. Puede llamar a la operación DescribeRegions para consultar el ID de región.	eu-central-1
VpnGatewayId	string	Sí	El ID de instancia del VPN gateway.	vpn-bp1a3kqjiiq9legfx****
PageNumber	integer	No	El número de página de la lista. Valor predeterminado: 1.	1
PageSize	integer	No	El número de entradas por página en una consulta paginada. Valor máximo: 50. Valor predeterminado: 10.	10

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
PageSize	integer	El número de entradas por página en una consulta paginada.	10
RequestId	string	El ID de la solicitud.	5BE01CD7-5A50-472D-AC14-CA181C5C03BE
PageNumber	integer	El número de página de la lista.	1
TotalCount	integer	El número total de entradas en la lista.	1
VpnPbrRouteEntries	object
VpnPbrRouteEntry	array<object>	La lista de rutas basadas en políticas.
	object	La información sobre la ruta basada en políticas.
NextHop	string	El siguiente salto de la ruta basada en políticas.	vco-bp15oes1py4i66rmd****
Weight	integer	El peso de la ruta basada en políticas. Para instancias de VPN gateway que admiten conexiones IPsec-VPN de túnel único, el valor de peso representa la prioridad de la ruta basada en políticas: 100: Prioridad alta. Si existen múltiples rutas basadas en políticas con los mismos bloques CIDR de origen y destino, la conexión IPsec-VPN asociada a esta ruta basada en políticas funciona como el enlace activo. 0: Prioridad baja. Si existen múltiples rutas basadas en políticas con los mismos bloques CIDR de origen y destino, la conexión IPsec-VPN asociada a esta ruta basada en políticas funciona como el enlace en espera. Nota Para instancias de VPN gateway que admiten conexiones IPsec-VPN de túnel dual, este parámetro no surte efecto.	100
RouteDest	string	El bloque CIDR de destino de la ruta basada en políticas.	10.0.0.0/24
State	string	El estado de publicación de la ruta basada en políticas. published: La ruta basada en políticas está publicada en la tabla de rutas de la VPC. normal: La ruta basada en políticas no está publicada en la tabla de rutas de la VPC.	published
CreateTime	integer	La marca de tiempo cuando se creó la ruta basada en políticas. Unidad: milisegundos. La marca de tiempo está en formato UNIX y representa el número total de milisegundos transcurridos desde el 1 de enero de 1970, 00:00:00 UTC.	1492747187000
VpnInstanceId	string	El ID de instancia del VPN gateway.	vpn-bp1a3kqjiiq9legfx****
RouteSource	string	El bloque CIDR de origen de la ruta basada en políticas.	192.168.0.0/24
Priority	integer	La prioridad de política de la ruta basada en políticas. Un valor menor indica una mayor prioridad para la ruta basada en políticas.	10
NextHopTunnelId	string	El ID de túnel asociado al siguiente salto de la ruta basada en políticas. Este parámetro se devuelve solo para instancias de VPN gateway que admiten conexiones IPsec-VPN de túnel dual.	tun-opsqc4d97wni2****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "PageSize": 10,
  "RequestId": "5BE01CD7-5A50-472D-AC14-CA181C5C03BE",
  "PageNumber": 1,
  "TotalCount": 1,
  "VpnPbrRouteEntries": {
    "VpnPbrRouteEntry": [
      {
        "NextHop": "vco-bp15oes1py4i66rmd****",
        "Weight": 100,
        "RouteDest": "10.0.0.0/24",
        "State": "published",
        "CreateTime": 1492747187000,
        "VpnInstanceId": "vpn-bp1a3kqjiiq9legfx****",
        "RouteSource": "192.168.0.0/24",
        "Priority": 10,
        "NextHopTunnelId": "tun-opsqc4d97wni2****"
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidVpnInstanceId.NotFound	The specified VPN was not found.	The specified VPN instance was not found.
400	InvalidVpnGatewayInstanceId.NotFound	The specified vpn gateway instance id does not exist.	The specified VPN gateway does not exist. Check whether the specified VPN gateway is valid.
403	Forbbiden.SubUser	User not authorized to operate on the specified resource as your account is created by another user.
403	Forbidden	User not authorized to operate on the specified resource.	You do not have the permissions to manage the specified resource. Apply for the permissions and try again.

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.