Ver detalles del disco

Después de crear un Persistent Disk o Hyperdisk en Compute Engine, puedes revisar la información sobre la configuración del disco. Puedes usar esta información para supervisar el rendimiento del disco, mejorar la seguridad de los datos y optimizar el almacenamiento y los costos. En este documento, se explica cómo ver los siguientes detalles esenciales del disco:

  • Es una lista de todos los discos disponibles en un proyecto, incluidos los que no están conectados a una instancia.
  • Instancias conectadas
  • Indica si un disco se borrará automáticamente con su instancia.
  • Modo de acceso
  • Métricas de rendimiento de capacidad de procesamiento y operaciones de entrada y salida por segundo (IOPS)
  • Información de encriptación

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

    2. Set a default region and zone.

    REST

    Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a gcloud CLI.

      Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Cómo ver todos los discos de un proyecto

Para obtener una vista integral de tus recursos de almacenamiento, puedes enumerar todos los discos de un proyecto, incluidos los que no están conectados a una instancia.

Console

En la consola de Google Cloud , ve a la página Discos.

Ir a Discos

En la página Discos, se enumeran todos los discos de tu proyecto.

gcloud

Ejecuta el comando disks list:

gcloud compute disks list

Resultado del comando

Es una lista de todos los volúmenes de Persistent Disk y Hyperdisk de tu proyecto.

Para ver los discos en una región o zona específica, usa la marca --zone o --region para especificar la ubicación.

REST

Realiza una solicitud POST al método compute.disks.aggregatedList.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/disks/

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto

Solicitar respuesta

Es una lista de todos los volúmenes de Persistent Disk y Hyperdisk de tu proyecto.

Cómo ver las instancias a las que está conectado un disco

Comprende cómo se usa tu disco y evita incurrir en costos por discos sin usar. Para ello, identifica qué instancias están conectadas a él.

Console

  1. En la consola de Google Cloud , ve a la página Discos.

    Ir a Discos

  2. En la columna Nombre, haz clic en el nombre del disco.

  3. En la tabla Propiedades, la fila etiquetada como En uso por enumera todas las instancias que están conectadas al disco.

gcloud

Ejecuta el comando gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME 

      --zone=ZONE
      --format="json(users)"

Reemplaza lo siguiente:

  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: el nombre del disco.

Resultado del comando

Si el resultado es null, el disco no está conectado a ninguna instancia. De lo contrario, el resultado es un objeto JSON que contiene un campo llamado users. El campo users enumera las URLs de todas las instancias que usan el disco.

REST

Realiza una solicitud POST al método compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto.
  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: el nombre del disco.

Solicitar respuesta

La respuesta de REST es un objeto JSON que contiene un campo llamado users.

Si el valor del campo users es null, el disco no está conectado a ninguna instancia. De lo contrario, el objeto users enumera las URLs de todas las instancias que usan el disco.

Cómo ver si un disco tiene habilitada la eliminación automática

Para evitar la pérdida accidental de datos, verifica si se borrará el disco de arranque o no cuando borres la instancia adjunta.

De forma predeterminada, los discos de arranque tienen habilitado el parámetro autoDelete, lo que significa que borrar una instancia también borra su disco de arranque conectado. Sin embargo, puedes anular este parámetro de configuración si deseas conservar el disco de arranque adjunto. Los discos que no son de arranque también se borrarán si tienen habilitada la opción autoDelete.

Console

  1. En la Google Cloud consola, ve a la página Instancias de VM.

    Ir a Instancias de VM

  2. En la columna Nombre, haz clic en el nombre de la instancia.

  3. En la sección Almacenamiento, navega a la columna Cuando se borra la instancia. When deleting instance puede tener uno de los siguientes valores:

    • Borrar disco: El disco se borrará con la instancia.
    • Mantener disco: El disco no se borrará con la instancia.

gcloud

Ejecuta el comando gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME 

      --zone=ZONE

Reemplaza lo siguiente:

  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: el nombre del disco.

Resultado del comando

Es un objeto JSON que contiene un campo llamado autoDelete. autoDelete describe si el disco se borrará con su instancia adjunta y puede tener uno de los siguientes valores:

  • true: El disco se borrará con la instancia.
  • false: El disco no se borrará con la instancia.

REST

Realiza una solicitud POST al método compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto.
  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: el nombre del disco.

Solicitar respuesta

Es un objeto JSON que contiene un campo llamado autoDelete. autodelete describe si el disco se borrará con su instancia adjunta y puede tener uno de los siguientes valores:

  • true: El disco se borrará con la instancia.
  • false: El disco no se borrará con la instancia.

Cómo ver cuánto espacio queda en un disco

Para ver cuánto espacio queda en un disco sin conectarte a la instancia adjunta, debes instalar el Agente de operaciones en tus instancias. El agente de operaciones proporciona métricas adicionales para bytes_used (bytes de disco usados) y percent_used (utilización del disco).

Para obtener más información sobre la supervisión del espacio en disco, consulta Métricas del agente de operaciones.

Cómo ver el modo de acceso de un Hyperdisk

El modo de acceso determina si un volumen de Hyperdisk se puede conectar a varias instancias y si las instancias conectadas tienen acceso de solo lectura o de lectura y escritura al disco.

Console

  1. En la consola de Google Cloud , ve a la página Discos.

    Ir a Discos

  2. En la columna Nombre, haz clic en el nombre del disco.

  3. En la tabla Propiedades, la fila etiquetada como Modo de acceso describe cómo las instancias pueden acceder a los datos del disco y puede tener uno de los siguientes valores:

    • Lectura y escritura en una sola VM (predeterminado), para el acceso de lectura y escritura desde una instancia.
    • Lectura y escritura en varias VMs, para el acceso de lectura y escritura desde varias instancias
    • Solo lectura en varias VMs, para el acceso de solo lectura desde varias instancias

gcloud

Ejecuta el comando gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME 

      --zone=ZONE 

      --format="json(accessMode)"

Reemplaza lo siguiente:

  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: el nombre del disco.

Resultado del comando

Es un objeto JSON que contiene un campo llamado accessMode. accessMode describe cómo las instancias pueden acceder a los datos del disco y puede tener uno de los siguientes valores:

  • READ_ONLY_MANY, para el acceso de solo lectura desde varias instancias.
  • READ_WRITE_MANY, para el acceso de lectura y escritura desde varias instancias.
  • READ_WRITE_SINGLE, para el acceso de lectura y escritura desde una instancia.

REST

Realiza una solicitud POST al método compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto.
  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: Es el nombre del disco

Solicitar respuesta

La respuesta de REST es un objeto JSON que contiene un campo llamado accessMode. accessMode describe cómo las instancias pueden acceder a los datos del disco y puede tener uno de los siguientes valores:

  • READ_ONLY_MANY, para el acceso de solo lectura desde varias instancias.
  • READ_WRITE_MANY, para el acceso de lectura y escritura desde varias instancias.
  • READ_WRITE_SINGLE, para el acceso de lectura y escritura desde una instancia.

Cómo determinar si un disco funciona según lo previsto

Los discos tienen límites para la cantidad máxima de IOPS y capacidad de procesamiento que pueden alcanzar. Estos límites dependen del tamaño del disco y de la instancia conectada. El rendimiento máximo de un disco no puede superar los límites de la instancia a la que está conectado.

Para determinar si un volumen de Hyperdisk o Persistent Disk funciona al nivel esperado según su tamaño y la instancia adjunta, completa los siguientes pasos:

  1. Verifica el rendimiento máximo o aprovisionado del disco.
  2. Compara el rendimiento aprovisionado o máximo con el rendimiento real del disco.

Los pasos para verificar el rendimiento aprovisionado o máximo de un disco dependen de si el disco es un Hyperdisk o un Persistent Disk.

Consulta el rendimiento aprovisionado de un Hyperdisk

Para ver los valores de IOPS y capacidad de procesamiento aprovisionados para un volumen de Hyperdisk, consulta Consulta la configuración de rendimiento aprovisionada de Hyperdisk.

Visualiza el rendimiento máximo de un Persistent Disk

Los volúmenes de Persistent Disk tienen límites de capacidad de procesamiento y de IOPS por GiB y por instancia que pueden admitir. En las siguientes secciones, se proporciona información detallada sobre los límites de rendimiento de los Persistent Disk zonales y regionales:

El disco persistente balanceado y el Persistent Disk SSD (rendimiento) también ofrecen un rendimiento de referencia para IOPS y capacidad de procesamiento sostenidas. Para calcular los valores máximos de IOPS y capacidad de procesamiento de un volumen de Persistent Disk balanceado o de disco persistente SSD, usa la siguiente ecuación:

Maximum expected performance = Baseline performance + (Per GiB performance limit * Combined disk size in GiB)

Para obtener más información, consulta Rendimiento de referencia.

Cómo ver el rendimiento real de un disco

Para ver el rendimiento de IOPS y capacidad de procesamiento de un disco, usa la consola de Google Cloud .

Console

  1. En la Google Cloud consola, ve a la página Instancias de VM.

    Ir a Instancias de VM

  2. En la columna Nombre, haz clic en el nombre de la VM a la que está conectado el disco.

  3. Haz clic en Observabilidad.

  4. En el menú, selecciona Disco > Rendimiento.

    Aparecerán gráficos que ilustran el rendimiento de IOPS y capacidad de procesamiento del disco. Para ver todos los gráficos, debes instalar el Agente de operaciones.

Para ver un informe más detallado sobre el rendimiento de un disco, consulta Revisa las métricas de rendimiento del disco.

Si el disco no funciona según lo esperado, revisa la guía en Supervisa el estado de un disco.

Visualiza información sobre la encriptación de un disco

Los discos en Compute Engine se encriptan con uno de los siguientes tipos de claves de encriptación:

  • Google-owned and managed keys
  • Claves de encriptación administradas por el cliente (CMEK)
  • Claves de encriptación proporcionadas por el cliente (CSEK)

De forma predeterminada, Compute Engine usa Google-owned and managed keys.

Console

  1. En la consola de Google Cloud , ve a la página Discos.

    Ir a Discos

  2. En la columna Nombre, haz clic en el nombre del disco.

  3. En la tabla Propiedades, la fila etiquetada Encriptación indica el tipo de encriptación: Administrada por Google, Administrada por el cliente o Suministrada por el cliente.

gcloud

Ejecuta el comando gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME 

      --zone=ZONE 

      --format="json(diskEncryptionKey)"

Reemplaza lo siguiente:

  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: el nombre del disco.

Resultado del comando

Si el resultado es null, el disco usa un Google-owned and managed key.

De lo contrario, el resultado es un objeto JSON.

Si el objeto JSON contiene un campo llamado diskEncryptionKey, el disco está encriptado. El objeto diskEncryptionKey contiene información sobre si el disco está encriptado con CMEK o CSEK:

  • Si la propiedad diskEncryptionKey.kmsKeyName está presente, el disco está encriptado con CMEK. La propiedad kmsKeyName indica el nombre de la clave específica que se usó para encriptar el disco: 
    {
  "diskEncryptionKey": {
    "kmsKeyName": "projects/my-proj/.."
  }
}
  • Si la propiedad diskEncryptionKey.sha256 está presente, el disco está encriptado con CSEK. La propiedad sha256 es el hash SHA-256 de la clave de encriptación proporcionada por el cliente que protege el disco. 
      {
    "diskEncryptionKey": {
      "sha256": "abcdefghijk134560459345dssfd"
    }
  }

REST

Realiza una solicitud POST al método compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto.
  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: Es el nombre del disco

Solicitar respuesta

Si la respuesta es null, el disco usa un Google-owned and managed key.

De lo contrario, la respuesta es un objeto JSON.

Si el objeto JSON contiene un campo llamado diskEncryptionKey, el disco está encriptado. El objeto diskEncryptionKey contiene información sobre si el disco está encriptado con CMEK o CSEK:

  • Si la propiedad diskEncryptionKey.kmsKeyName está presente, el disco está encriptado con CMEK. La propiedad kmsKeyName indica el nombre de la clave específica que se usó para encriptar el disco: 
    {
  "diskEncryptionKey": {
    "kmsKeyName": "projects/my-proj/.."
  }
}
  • Si la propiedad diskEncryptionKey.sha256 está presente, el disco está encriptado con CSEK. La propiedad sha256 es el hash SHA-256 de la clave de encriptación proporcionada por el cliente que protege el disco. 
      {
    "diskEncryptionKey": {
      "sha256": "abcdefghijk134560459345dssfd"
    }
  }

Si el disco usa CMEK, puedes encontrar información detallada sobre la clave, su llavero de claves y su ubicación si sigues los pasos en Visualiza claves por proyecto.

Si el disco usa CSEK, comunícate con el administrador de tu organización para obtener detalles sobre la clave. Si usas una CMEK, también puedes ver qué recursos protege esa clave con el seguimiento de uso de las claves. Para obtener más información, consulta Visualiza el uso de claves.

Cómo ver todos los detalles de un disco

Para obtener información general sobre tu disco, puedes ver todas sus propiedades a la vez.

Console

  1. En la consola de Google Cloud , ve a la página Discos.

    Ir a Discos

  2. En la columna Nombre, haz clic en el nombre del disco.

    Aparecerá la tabla Properties con un resumen de la información básica del disco.

  3. Para ver información adicional sobre el disco, haz clic en EQUIVALENT REST.

    Aparecerá una ventana de diálogo con la respuesta original de REST de la API de Compute Engine.

gcloud

Ejecuta el comando gcloud compute disks describe:

  gcloud compute disks describe DISK_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

  • DISK_NAME: el nombre del disco.
  • ZONE: Es la zona en la que se encuentra el disco.

Resultado del comando

Son todos los datos asociados con el disco de Compute Engine.

REST

Realiza una solicitud POST al método compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto.
  • ZONE: Es la zona en la que se encuentra el disco.
  • DISK_NAME: Es el nombre del disco

Solicitar respuesta

La respuesta de REST contiene todos los datos asociados con el disco de Compute Engine.

¿Qué sigue?