> ## 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.
# Obtener puerta de enlace de internet
Requiere la acción de IAM **`network:GetInternetGateway`**. 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/internet-gateways/{internet_gateway_id}
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/internet-gateways/{internet_gateway_id}:
get:
tags:
- Networking
summary: Obtener puerta de enlace de internet
operationId: getInternetGateway
parameters:
- $ref: '#/components/parameters/InternetGatewayId'
responses:
'200':
description: Detalles de la puerta de enlace de Internet
content:
application/json:
schema:
$ref: '#/components/schemas/InternetGatewayResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalServerError'
security:
- BearerAuth: []
components:
parameters:
InternetGatewayId:
name: internet_gateway_id
in: path
description: ID de la puerta de enlace de Internet
required: true
schema:
type: string
format: uuid
example: 550e8400-e29b-41d4-a716-446655440000
schemas:
InternetGatewayResponse:
type: object
properties:
internet_gateway:
$ref: '#/components/schemas/InternetGateway'
InternetGateway:
type: object
required:
- id
- crn
- name
- 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:internet-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: Internet gateway for the production VPC
attached_vpc_id:
type: string
format: uuid
nullable: true
description: >-
VPC a la que está actualmente conectado el IGW (null cuando está
desconectado).
example: 5f8d3a2e-1c4b-4e7a-9f6d-2b1a8c3e5d7f
tags:
type: object
additionalProperties:
type: string
created_at:
type: string
format: date-time
readOnly: true
updated_at:
type: string
format: date-time
readOnly: 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
responses:
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.