> ## 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 las interfaces de red de la instancia

> Enumera las NIC en orden de arranque. Todas las direcciones directamente adjuntas, prefijos enrutados e identidades IP flotantes se leen aquí; los objetos de instancia no tienen campos de resumen IP.

<Info>
  Requiere la acción de IAM **`compute:GetInstance`**. Consulte [permisos de computación](/es/compute/permissions) para obtener la lista completa, lo que cubre cada una y un ejemplo de directiva.
</Info>


## OpenAPI

````yaml /es/api-reference/specs/compute.yaml get /v1/instances/{instance_id}/nics
openapi: 3.0.3
info:
  title: Basaltic Compute API
  version: 1.0.0
  description: >
    Instancias de máquinas virtuales y las imágenes, los tipos de instancia y
    los grupos de instancias a partir de los cuales se crean. Cubre todo el
    ciclo de vida de la instancia: inicio, parada, reinicio, cambio de tamaño y
    reinstalación.
  contact:
    name: Basaltic Support
    email: ping@basaltic.sh
  license:
    name: Proprietary
    url: https://basaltic.sh/terms
servers:
  - url: https://compute.{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/instances/{instance_id}/nics:
    get:
      tags:
        - Compute
      summary: Listar las interfaces de red de la instancia
      description: >-
        Enumera las NIC en orden de arranque. Todas las direcciones directamente
        adjuntas, prefijos enrutados e identidades IP flotantes se leen aquí;
        los objetos de instancia no tienen campos de resumen IP.
      operationId: listInstanceNICs
      parameters:
        - $ref: '#/components/parameters/ComputeNameFilter'
        - $ref: '#/components/parameters/ComputeCRNFilter'
        - $ref: '#/components/parameters/InstanceId'
      responses:
        '200':
          description: Lista de NIC
          content:
            application/json:
              schema:
                type: object
                properties:
                  nics:
                    type: array
                    items:
                      type: object
                      required:
                        - interface_id
                        - boot_index
                        - primary
                        - external
                        - addresses
                        - routed_prefixes
                        - subnet
                      properties:
                        interface_id:
                          type: string
                          format: uuid
                          example: e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d
                        boot_index:
                          type: integer
                          example: 0
                        primary:
                          type: boolean
                          description: >-
                            La NIC de índice de arranque más bajo, la que lleva
                            las rutas predeterminadas y de metadatos del
                            invitado.
                          example: true
                        external:
                          type: boolean
                          description: >-
                            Una interfaz independiente adjunta al cliente:
                            detach la desata en lugar de destruirla.
                          example: false
                        name:
                          type: string
                          example: web-1-nic0
                        mac:
                          type: string
                          example: 02:1a:2b:3c:4d:5e
                        subnet:
                          anyOf:
                            - $ref: '#/components/schemas/Subnet'
                            - type: object
                              nullable: true
                              enum:
                                - null
                          description: >-
                            Ubicación de subred; null cuando la subred a la que
                            se hace referencia ya no existe.
                        addresses:
                          type: array
                          items:
                            $ref: '#/components/schemas/InterfaceAddress'
                        routed_prefixes:
                          type: array
                          items:
                            $ref: '#/components/schemas/RoutedPrefix'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - BearerAuth: []
components:
  parameters:
    ComputeNameFilter:
      name: name
      in: query
      description: >-
        Nombre exacto, que distinga entre mayúsculas y minúsculas. Los valores
        vacíos no coinciden con recursos con nombre. Las listas de NIC de
        instancia coinciden con los nombres de interfaz dentro de las
        vinculaciones de instancia; pueden coincidir varias interfaces con el
        mismo nombre. Las IP flotantes no tienen identidad de nombre y devuelven
        una lista vacía para este filtro.
      schema:
        type: string
    ComputeCRNFilter:
      name: crn
      in: query
      description: >-
        CRN exacto del recurso, intersecado con todos los demás filtros antes de
        la paginación. Un CRN extranjero o no coincidente devuelve una página
        vacía; los CRN mal formados o vacíos devuelven 400. Las listas de
        archivos adjuntos anidados filtran el recurso representado, no el
        enlace.
      schema:
        type: string
    InstanceId:
      name: instance_id
      in: path
      description: ID de instancia
      required: true
      schema:
        type: string
        format: uuid
      example: 550e8400-e29b-41d4-a716-446655440000
  schemas:
    Subnet:
      type: object
      required:
        - id
        - crn
        - vpc
        - route_table
        - name
        - cidr_ipv4
        - gateway_ipv4
        - 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:vpc/prod/subnet/prod-web
        vpc:
          $ref: '#/components/schemas/Vpc'
        route_table:
          $ref: '#/components/schemas/RouteTableSummary'
        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: prod-web
        description:
          type: string
          example: Public web-tier subnet
        cidr_ipv4:
          type: string
          example: 10.0.1.0/24
        gateway_ipv4:
          type: string
          example: 10.0.1.1
        cidr_ipv6:
          type: string
          nullable: true
          readOnly: true
          description: >-
            La IPv6 /64 de doble pila, si la subred está habilitada para v6. Su
            presencia (vs el v4 cidr_ipv4) es la forma en que un cliente
            distingue las familias de la subred.
          example: 2a13:9500:1a6:100::/64
        gateway_ipv6:
          type: string
          nullable: true
          readOnly: true
          example: 2a13:9500:1a6:100::1
        tags:
          type: object
          additionalProperties:
            type: string
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
    InterfaceAddress:
      type: object
      properties:
        id:
          type: string
          format: uuid
        family:
          type: string
          enum:
            - ipv4
            - ipv6
        address:
          type: string
        prefix:
          type: string
          description: >-
            Asignación propia, no la máscara de red de invitado: IPv4 /32 o IPv6
            /96. DHCPv6 configura el primer /128.
        primary:
          type: boolean
        floating_ips:
          type: array
          items:
            $ref: '#/components/schemas/AddressFloatingIp'
      required:
        - id
        - family
        - address
        - prefix
        - primary
        - floating_ips
    RoutedPrefix:
      type: object
      properties:
        id:
          type: string
          format: uuid
        pool_id:
          type: string
          format: uuid
        family:
          type: string
          enum:
            - ipv4
        prefix:
          type: string
          description: Un /28 enrutado desde un grupo de prefijos de VPC.
      required:
        - id
        - pool_id
        - family
        - prefix
    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
    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
    AddressFloatingIp:
      type: object
      properties:
        id:
          type: string
          format: uuid
        crn:
          type: string
        visibility:
          type: string
          enum:
            - public
            - private
        address:
          type: string
      required:
        - id
        - crn
        - visibility
        - address
    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:
    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
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >+
        Un token bearer de OAuth 2.0, enviado como `Authorization: Bearer
        <token>`. 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.