> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Listar rutas de puerta de enlace solo de salida
> Enumera las rutas que se dirigen a esta puerta de enlace de salida únicamente, la más reciente primero, con identidad de tabla de rutas. Requiere acceso de lectura a la puerta de enlace. Solo se devuelven las rutas en las tablas donde el llamador tiene el permiso network:ListRoutes; la paginación se aplica a esas rutas visibles.
Acción de IAM principal: **`network:GetEgressOnlyGateway`**. Además, comprueba network:ListRoutes en cada tabla de rutas propietaria, incluyendo las condiciones de las etiquetas de recursos. Las rutas en las tablas denegadas se omiten. Consulte [permisos de redes](/es/networking/permissions) para obtener ejemplos de directivas.
## OpenAPI
````yaml /es/api-reference/specs/network.yaml get /v1/egress-only-gateways/{egress_only_gateway_id}/routes
openapi: 3.0.3
info:
title: Basaltic Network API
version: 1.0.0
description: >
La superficie de VPC: redes y subredes, interfaces, tablas de rutas, grupos
de seguridad, Internet, NAT y puertas de enlace solo de salida, e IP
flotantes.
Las entradas de relación usan un campo de referencia: UUID, CRN o un nombre
exacto cuando la solicitud proporciona su ámbito principal requerido. Las
subredes y las tablas de rutas tienen ámbito de VPC; las interfaces tienen
ámbito de subred./subnet/, vpc//route-table/, y
vpc//subnet//interfaz/Los nombres son inmutables.
Los campos de petición desconocidos y los parámetros de lista son
rechazados. Las referencias vacías suministradas son inválidas y las
búsquedas fallidas nunca caen de nuevo a otro tipo de referencia.
contact:
name: Basaltic Support
email: ping@basaltic.sh
license:
name: Proprietary
url: https://basaltic.sh/terms
servers:
- url: https://network.{region}.basaltic.sh
description: Punto final de API regional
variables:
region:
default: sa-saopaulo-1
description: Código de región
security:
- BearerAuth: []
paths:
/v1/egress-only-gateways/{egress_only_gateway_id}/routes:
get:
tags:
- Networking
summary: Listar rutas de puerta de enlace solo de salida
description: >-
Enumera las rutas que se dirigen a esta puerta de enlace de salida
únicamente, la más reciente primero, con identidad de tabla de rutas.
Requiere acceso de lectura a la puerta de enlace. Solo se devuelven las
rutas en las tablas donde el llamador tiene el permiso
network:ListRoutes; la paginación se aplica a esas rutas visibles.
operationId: listEgressOnlyGatewayRoutes
parameters:
- name: name
in: query
description: >-
Nombre exacto del recurso. Este recurso no tiene nombre, por lo que
un nombre proporcionado devuelve un resultado vacío.
schema:
type: string
- name: crn
in: query
description: >-
CRN exacto, validado con el tipo de punto final, la región y la
cuenta de llamada. Los CRN extraños o no coincidentes válidos
devuelven un resultado vacío; los CRN hijos malformados o planos
devuelven 400. Los filtros son conjuntivos.
schema:
type: string
- $ref: '#/components/parameters/EgressOnlyGatewayId'
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 500
default: 50
example: 50
- name: marker
in: query
schema:
type: string
format: uuid
example: a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f
description: Resume token — el último id de la página anterior.
responses:
'200':
description: Lista de rutas
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayRouteListResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalServerError'
security:
- BearerAuth: []
components:
parameters:
EgressOnlyGatewayId:
name: egress_only_gateway_id
in: path
description: ID de puerta de enlace de salida única
required: true
schema:
type: string
format: uuid
example: b7d3f1a9-2c8e-4b6d-9f1a-3e5c7d2b8a4f
schemas:
GatewayRouteListResponse:
type: object
required:
- routes
- meta
properties:
routes:
type: array
items:
$ref: '#/components/schemas/GatewayRoute'
meta:
$ref: '#/components/schemas/PaginationMeta'
GatewayRoute:
allOf:
- $ref: '#/components/schemas/Route'
- type: object
required:
- route_table
properties:
route_table:
$ref: '#/components/schemas/RouteTableSummary'
PaginationMeta:
type: object
properties:
total:
type: integer
description: Número total de artículos
example: 150
limit:
type: integer
description: Número de artículos por página
example: 20
marker:
type: string
description: >-
Cursor opaco para la página siguiente. Pasalo de vuelta como el
parámetro de consulta `marker`; trátalo como un token, no como un
valor para analizar.
example: 550e8400-e29b-41d4-a716-446655440000
has_more:
type: boolean
description: Si hay más artículos
example: true
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- request_id
properties:
code:
type: string
description: Código de error que identifica el tipo de error
example: INVALID_INPUT
message:
type: string
description: Mensaje de error legible por el ser humano
example: Invalid request parameters
params:
type: object
additionalProperties: true
description: >-
Valores no sensibles opcionales para la interpolación de errores
localizados, codificados por código de error. Nunca presente por
errores del servidor.
example:
instances: 2
pools: 0
request_id:
type: string
format: uuid
description: Solicitar ID para depuración
example: 550e8400-e29b-41d4-a716-446655440000
Route:
type: object
required:
- id
- crn
- route_table_id
- destination_cidr
- target_type
- tags
- created_at
- updated_at
properties:
id:
type: string
format: uuid
readOnly: true
crn:
type: string
readOnly: true
example: crn:network:sa-saopaulo-1:my-account:route/
route_table_id:
type: string
format: uuid
example: a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f
description:
type: string
example: Default route to the internet gateway
destination_cidr:
type: string
example: 0.0.0.0/0
target_type:
$ref: '#/components/schemas/RouteTargetType'
next_hop_ip:
type: string
nullable: true
description: >-
Establecido cuando target_type=ip. Mutex con los campos target_*_id.
Debe ser una dirección de unicast dentro del CIDR de esta VPC (la
misma familia IP que destination_cidr); la salida de Internet usa
target_internet_gateway_id / target_nat_gateway_id.
example: 10.0.1.1
target_internet_gateway_id:
type: string
format: uuid
nullable: true
description: Establecido cuando target_type=puerta_de_entrada_de_internet.
example: c4f7a2e9-8d1b-4e6c-9a3f-5b2d7c1e8a4f
target_nat_gateway_id:
type: string
format: uuid
nullable: true
description: >-
Establecido cuando target_type=nat_gateway. Admite IPv4 e IPv6; IPv6
requiere una subred de alojamiento habilitada para IPv6.
example: e2a8c5f1-3b9d-4c7e-8a1f-6d4b2e9c3a5f
target_egress_only_gateway_id:
type: string
format: uuid
nullable: true
description: >-
Establecido cuando target_type=egress_only_gateway (solo IPv6). Da
la subred saliente v6 con Internet incapaz de iniciar la entrada.
example: b7d3f1a9-2c8e-4b6d-9f1a-3e5c7d2b8a4f
tags:
type: object
additionalProperties:
type: string
created_at:
type: string
format: date-time
readOnly: true
updated_at:
type: string
format: date-time
readOnly: true
RouteTableSummary:
type: object
nullable: true
additionalProperties: false
description: >
Tabla de rutas utilizada por una subred, sin repetir su VPC. Null cuando
la búsqueda no propietaria ya no se resuelve, por ejemplo, durante la
reasociación y eliminación simultáneas de la tabla anterior. Se rechaza
la eliminación de una tabla que todavía está asociada con subredes.
required:
- id
- crn
- name
properties:
id:
type: string
format: uuid
readOnly: true
crn:
type: string
readOnly: true
example: >-
crn:network:sa-saopaulo-1:my-account:vpc/prod/route-table/prod-private-rt
name:
type: string
example: prod-private-rt
RouteTargetType:
type: string
enum:
- ip
- internet_gateway
- nat_gateway
- egress_only_gateway
description: >
Discriminador para el destino de la ruta. Los nuevos tipos de destino
(interface, vpc_peering, …) amplían este enum y añaden su propio campo
target_*. Refleja el estilo de AWS de un campo por destino: se debe
establecer exactamente una propiedad target_* en create.
responses:
BadRequest:
description: Parámetros de solicitud no válidos
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INVALID_INPUT
message: Invalid request parameters
request_id: 550e8400-e29b-41d4-a716-446655440000
Unauthorized:
description: Se requiere autenticación o el token no es válido
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: Authentication required
request_id: 550e8400-e29b-41d4-a716-446655440000
Forbidden:
description: Permisos insuficientes
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: ACCESS_DENIED
message: You don't have permission to perform this action
request_id: 550e8400-e29b-41d4-a716-446655440000
NotFound:
description: No se encontró el recurso
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: Resource not found
request_id: 550e8400-e29b-41d4-a716-446655440000
InternalServerError:
description: Error interno del servidor
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INTERNAL_ERROR
message: An internal error occurred
request_id: 550e8400-e29b-41d4-a716-446655440000
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >+
Un token bearer de OAuth 2.0, enviado como `Authorization: Bearer
`. Esta es la forma recomendada de autenticación.
Obtén el token intercambiando el par de claves de acceso de una cuenta
de servicio en `POST /v1/oauth/token` con
`grant_type=client_credentials`. Es el flujo estándar de credenciales de
cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar
el token por ti.
```
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
```
Los tokens duran una hora por defecto. El mismo par de claves de acceso
también sirve como credencial AWS SigV4 para el endpoint de objetos
compatible con S3, que solo acepta ese método de autenticación.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.