> ## 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 puertas de enlace de solo salida
Requiere la acción de IAM **`network:ListEgressOnlyGateways`**. Consulte [permisos de redes](/es/networking/permissions) para obtener la lista completa, lo que cubre cada una y un ejemplo de directiva.
## OpenAPI
````yaml /es/api-reference/specs/network.yaml get /v1/egress-only-gateways
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:
get:
tags:
- Networking
summary: Listar puertas de enlace de solo salida
operationId: listEgressOnlyGateways
parameters:
- name: name
in: query
description: Nombre exacto del recurso.
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
- 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: b7d3f1a9-2c8e-4b6d-9f1a-3e5c7d2b8a4f
description: Resume token — el último id de la página anterior.
responses:
'200':
description: Lista de puertas de enlace de salida
content:
application/json:
schema:
$ref: '#/components/schemas/EgressOnlyGatewayListResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'500':
$ref: '#/components/responses/InternalServerError'
security:
- BearerAuth: []
components:
schemas:
EgressOnlyGatewayListResponse:
type: object
required:
- egress_only_gateways
- meta
properties:
egress_only_gateways:
type: array
items:
$ref: '#/components/schemas/EgressOnlyGateway'
meta:
$ref: '#/components/schemas/PaginationMeta'
EgressOnlyGateway:
type: object
description: >-
Salida IPv6 nativa sin traducción de direcciones: una subred con IPv6
global cuya tabla de rutas apunta a ::/0 en uno obtiene OUTBOUND v6 (más
el tráfico de retorno de sus propios flujos), pero Internet nunca puede
iniciar una conexión entrante; una caída de banda de plataforma hace que
esto sea necesario independientemente de los grupos de seguridad del
inquilino. No posee ninguna dirección y no traduce los orígenes de ULA y
reutiliza la puerta de enlace de Internet de la VPC para el enlace
ascendente L3, por lo que la VPC debe tener un IGW adjunto. Uno por VPC.
required:
- id
- crn
- name
- vpc
- 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:egress-only-gateway/main
name:
description: >-
Los nombres de los recursos no deben comenzar con el prefijo literal
crn: ni ser UUID (en cualquier caso, en las formas canónica,
compacta, entre corchetes o urn:uuid:).
type: string
example: main
description:
type: string
example: Egress-only v6 for the private tier
vpc:
$ref: '#/components/schemas/Vpc'
tags:
type: object
additionalProperties:
type: string
created_at:
type: string
format: date-time
readOnly: true
updated_at:
type: string
format: date-time
readOnly: true
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
Vpc:
type: object
required:
- id
- crn
- name
- cidr_ipv4
- tags
- created_at
- updated_at
properties:
id:
type: string
format: uuid
readOnly: true
crn:
type: string
readOnly: true
description: >-
Nombre de recurso de Cloud (basado en nombre, región+ámbito de
cuenta).
example: crn:network:sa-saopaulo-1:my-account:vpc/prod
name:
type: string
description: >-
De 1 a 63 caracteres alfanuméricos en minúsculas y guiones. Los
nombres de recursos no deben comenzar con el prefijo literal crn: ni
ser UUID (en formato canónico, compacto, entre llaves o urn:uuid:,
tanto en mayúsculas como en minúsculas).
example: prod
description:
type: string
example: Production VPC for web and app tiers
cidr_ipv4:
type: string
description: >-
Bloque CIDR IPv4 dividido por subredes. Debe ser privado (RFC 1918):
dentro de 10.0.0.0/8, 172.16.0.0/12 o 192.168.0.0/16. Inmutable
después de crear.
example: 10.0.0.0/16
cidr_ipv6:
type: string
nullable: true
readOnly: true
description: Prefijo GUA regional asociado o ULA privado.
example: 2a13:9500:1a6:100::/60
tags:
type: object
additionalProperties:
type: string
created_at:
type: string
format: date-time
readOnly: true
updated_at:
type: string
format: date-time
readOnly: true
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
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.