> ## 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 los volúmenes adjuntos de la instancia

> Devuelve los enlaces de volumen de la instancia ordenados por índice de arranque (primero el disco de arranque), cada uno resuelto con el nombre/tipo/tamaño/estado actual del volumen.


<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}/volumes
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}/volumes:
    get:
      tags:
        - Compute
      summary: Listar los volúmenes adjuntos de la instancia
      description: >
        Devuelve los enlaces de volumen de la instancia ordenados por índice de
        arranque (primero el disco de arranque), cada uno resuelto con el
        nombre/tipo/tamaño/estado actual del volumen.
      operationId: listInstanceVolumes
      parameters:
        - $ref: '#/components/parameters/ComputeNameFilter'
        - $ref: '#/components/parameters/ComputeCRNFilter'
        - $ref: '#/components/parameters/InstanceId'
      responses:
        '200':
          description: Lista de volúmenes adjuntos
          content:
            application/json:
              schema:
                type: object
                properties:
                  attachments:
                    type: array
                    items:
                      type: object
                      properties:
                        volume_id:
                          type: string
                          format: uuid
                          example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        device:
                          type: string
                          example: vdb
                        boot_index:
                          type: integer
                          example: 1
                        delete_on_termination:
                          type: boolean
                          example: false
                        mount_path:
                          type: string
                          example: /data
                        fstype:
                          type: string
                          enum:
                            - ext4
                            - xfs
                          description: >-
                            Sistema de archivos con el que el agente invitado
                            formateó el volumen, o ausente cuando el archivo
                            adjunto no nombró uno y el agente utilizó el sistema
                            de archivos ext4 predeterminado. Cada ruta de
                            escritura — creación de instancia, plantilla de
                            agrupación y adjunto — rechaza cualquier otra cosa,
                            por lo que este es el conjunto completo que puede
                            contener el campo.
                        name:
                          type: string
                          example: web-1-data
                        volume_type:
                          type: string
                          example: ssd
                        size_gb:
                          type: integer
                          example: 100
                        status:
                          type: string
                          example: in_use
                        bootable:
                          type: boolean
                          example: false
                        mount:
                          $ref: '#/components/schemas/VolumeMount'
        '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:
    VolumeMount:
      type: object
      description: >
        Lo que el agente invitado informó sobre este adjunto.


        Presente solo en un archivo adjunto que lleva un `mount_path`. Un
        volumen sin uno se adjunta como un dispositivo de bloque desnudo que es
        propiedad del inquilino: nada lo reconcilia, por lo que no hay informes
        sobre él y un estado para él sería una reclamación sobre algo que nadie
        está viendo.


        El agente se instala en el primer arranque y nada lo actualiza después,
        por lo que una instancia más antigua que esta característica no reporta
        nada y cada uno de sus volúmenes lee `unknown`. Tratamiento `unknown`
        Como "sin información", nunca tan saludable.
      required:
        - state
      properties:
        state:
          type: string
          enum:
            - unknown
            - pending
            - mounted
            - failed
          description: >
            - `unknown` — ningún agente invitado ha reportado sobre este
            volumen. El agente puede ser anterior a esta característica, puede
            haber sido eliminado (lo cual es compatible) o el invitado puede no
            haber arrancado nunca.

            - `pending` — el agente no puede montarlo todavía y espera que eso
            cambie. El estado ordinario durante los primeros segundos después de
            un enlace, mientras el disco conectado en caliente aparece en el
            invitado.

            - `mounted` — montado en `mount_path`. Pueden todavía llevar un
            `code`.

            - `failed` — no se montará hasta que algo cambie. O bien el agente
            reportó un rechazo que no se puede arreglar esperando, o no ha
            podido avanzar por el tiempo suficiente como para que la espera ya
            no sea la explicación. `code` dice cual.
        code:
          type: string
          enum:
            - unsafe_serial
            - device_absent
            - probe_failed
            - signatures_no_filesystem
            - unsupported_fstype
            - mkfs_failed
            - unsafe_mount_path
            - mkdir_failed
            - mount_failed
            - fstab_write_failed
            - unknown_error
          description: >
            Por qué el volumen está en este estado. Ausente cuando no hay nada
            que decir.


            Independiente de `state` en lugar de algo que solo un error lleva:
            `fstab_write_failed` acompaña a un volumen **montado** cuya entrada
            de fstab no pudo ser escrita, que funciona ahora y desaparecerá
            después del próximo reinicio.


            El más común para actuar es `signatures_no_filesystem` — el disco
            lleva una tabla de particiones u otras firmas pero no un sistema de
            archivos montable, por lo que el agente no lo formateará, porque
            formatearlo destruiría lo que hay allí. Un volumen clonado desde un
            disco de arranque y conectado con una `mount_path` aterriza aquí.
            Particione y formatee dentro del huésped, o adjúntelo sin una
            `mount_path` y muéndelo usted mismo.


            `unknown_error` es un código que esta plataforma no reconoce,
            reportado por un agente invitado más nuevo que la región.
        message:
          type: string
          maxLength: 256
          description: >
            Detalle legible por el ser humano desde el interior del huésped — la
            salida del comando que falló, el tipo de tabla de particiones que
            encontró. Texto libre que se origina en la propia VM del cliente:
            desinfectado y limitado, pero se muestra como texto, nunca como
            marcado.
          example: >-
            /dev/disk/by-id/virtio-9f2c has a gpt partition table but no
            mountable filesystem, so this agent will not format it; formatting
            would destroy what is there
        since:
          type: string
          format: date-time
          description: >-
            Cuando el volumen entró en esta condición. Ausente cuando `state` es
            `unknown`.
        reported_at:
          type: string
          format: date-time
          description: >-
            Cuando el agente invitado informó por última vez, si algo había
            cambiado o no. Un `reported_at` muy lejos en el pasado significa que
            el agente ha dejado de hablar con nosotros, y el estado al lado es
            lo que dijo por última vez en lugar de lo que es cierto ahora.
            Ausente cuando `state` es `unknown`.
    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.