Gestionar grupos de almacenamiento de Hyperdisk

En este documento se explica cómo enumerar, describir, modificar y eliminar grupos de almacenamiento.

Antes de empezar

  • Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos 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 la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    REST

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

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

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Roles y permisos necesarios

Para obtener los permisos que necesitas para gestionar un pool de almacenamiento, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

  • Administrador de instancias de Compute (v. 1) (roles/compute.instanceAdmin.v1)
  • Para conectarte a una instancia de VM que pueda ejecutarse como cuenta de servicio, haz lo siguiente: Usuario de cuenta de servicio (v. 1) (rol roles/iam.serviceAccountUser)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para gestionar un pool de almacenamiento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Se necesitan los siguientes permisos para gestionar un grupo de almacenamiento:

  • Para enumerar los grupos de almacenamiento de un proyecto y una zona, haz lo siguiente: compute.storagePools.list
  • Para enumerar los discos de un grupo de almacenamiento, haz lo siguiente: compute.storagePools.get
  • Para ver las propiedades de un grupo de almacenamiento, sigue estos pasos: compute.storagePools.get
  • Para actualizar la capacidad aprovisionada o el rendimiento de un grupo de almacenamiento, sigue estos pasos:
    • compute.storagePools.get
    • compute.storagePools.update
  • Para eliminar un pool de almacenamiento, sigue estos pasos: compute.storagePools.delete

También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.

Limitaciones

Ten en cuenta las siguientes limitaciones al gestionar grupos de almacenamiento de Hyperdisk:

  • Puedes cambiar la capacidad aprovisionada o el rendimiento de un grupo de almacenamiento como máximo dos veces en un periodo de 24 horas.
  • No puedes cambiar el modelo de aprovisionamiento de un grupo. Tampoco puedes cambiar un grupo de almacenamiento de capacidad estándar a uno de capacidad avanzada, ni un grupo de almacenamiento de rendimiento avanzado a uno de rendimiento estándar.
  • No se pueden mover discos dentro ni fuera de un grupo de almacenamiento. Para mover un disco a un grupo de almacenamiento o sacarlo de él, tienes que volver a crear el disco a partir de una instantánea. Para obtener más información, consulta Cambiar el tipo de disco.
  • No puedes clonar, crear capturas instantáneas ni configurar la replicación asíncrona de discos en un pool de almacenamiento.
  • Puedes eliminar un máximo de 5 grupos de almacenamiento por hora.
  • El comando de gestión del grupo de almacenamiento se completa o falla inmediatamente, pero la acción puede tardar hasta 5 minutos en completarse y los cambios pueden tardar hasta 30 minutos en aparecer.

Para ver la lista completa de limitaciones de los grupos de almacenamiento de Hyperdisk, consulta Limitaciones de los grupos de almacenamiento.

Intervalos de valores al modificar grupos de almacenamiento

Al crear un grupo de almacenamiento, los nuevos valores de tamaño, IOPS y rendimiento deben estar dentro de los límites del tipo de grupo de almacenamiento que esté modificando. Además, solo puede especificar valores nuevos con valores incrementales admitidos.

Para consultar los límites de aprovisionamiento de rendimiento detallados, consulta Límites de los grupos de almacenamiento.

Mostrar los grupos de almacenamiento de un proyecto

Para ver los grupos de almacenamiento que se han creado en un proyecto, usa laGoogle Cloud consola, la CLI de Google Cloud o REST.

Consola

  1. Ve a la página Grupos de almacenamiento de la consola de Google Cloud .
    Ir a la página Grupos de almacenamiento

    En la página se muestran los grupos de almacenamiento creados en el proyecto seleccionado.

  2. Opcional: Usa la barra Filtrar para mostrar solo los grupos de almacenamiento que coincidan con los parámetros de filtro, como Ubicación, Tipo, Nombre y Capacidad restante del grupo.

gcloud

Para obtener una lista de todos los grupos de almacenamiento creados en el proyecto actual, usa el comando gcloud compute storage-pools list.

gcloud compute storage-pools list

Para limitar los resultados a una región o zona concretas, puedes usar la marca --filter. Por ejemplo:

  • --filter="zone ~ us
  • --filter="zone=us-east4-c"

REST

Para mostrar los grupos de almacenamiento creados en un proyecto y una zona, crea una solicitud GET con el método storagePools.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto que contiene el grupo de almacenamiento
  • ZONE: la zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a.

Mostrar los discos de un grupo de almacenamiento

Para obtener una lista de los discos creados en un pool de almacenamiento, usa laGoogle Cloud consola, la CLI de Google Cloud o REST.

Consola

  1. Ve a la página Grupos de almacenamiento de la consola de Google Cloud .
    Ir a la página Grupos de almacenamiento

    En la página se muestran los grupos de almacenamiento creados en el proyecto seleccionado.

  2. En el campo Nombre, haga clic en el nombre del grupo de almacenamiento que quiera ver.

    Se abrirá la página Gestionar grupo de almacenamiento.

  3. En la sección Discos del grupo de almacenamiento, puedes ver los discos que se han creado en el grupo de almacenamiento.

gcloud

Para enumerar los discos que se han creado en un grupo de almacenamiento, usa el comando gcloud compute storage-pools list-disks.

gcloud compute storage-pools list-disks STORAGE_POOL_NAME  \
    [--zone=ZONE]

Haz los cambios siguientes:

  • STORAGE_POOL_NAME: el nombre del grupo de almacenamiento.
  • ZONE: opcional. La zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a.

REST

Para enumerar los discos que usan un grupo de almacenamiento, crea una solicitud GET con el método storagePools.listDisks.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto que contiene el grupo de almacenamiento
  • ZONE: la zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a.
  • STORAGE_POOL_NAME: el nombre del grupo de almacenamiento.

Describe un grupo de almacenamiento

Para ver los detalles de un grupo de almacenamiento, puedes usar la Google Cloud consola, la interfaz de línea de comandos de Google Cloud o REST.

Consola

  1. Ve a la página Grupos de almacenamiento de la consola de Google Cloud .
    Ir a la página Grupos de almacenamiento

  2. En cada grupo de almacenamiento que aparece en la página, puede ver la siguiente información:

    • Estado
    • Nombre
    • Ubicación
    • Tipo de piscina
    • Capacidad de la piscina
    • Capacidad restante del grupo
    • IOPS del grupo
    • IOPS restantes del grupo
    • Número de discos creados en el grupo

  3. En el campo Nombre, haz clic en el nombre del grupo de almacenamiento que quieras ver.

    Se abrirá la página Gestionar grupo de almacenamiento.

  4. En las baldosas de la parte superior de la página, puedes ver la capacidad aprovisionada y utilizada, así como el rendimiento y las IOPS aprovisionadas y utilizadas del grupo de almacenamiento.

  5. En la sección Configuración del almacenamiento compartido, puede ver propiedades adicionales del almacenamiento compartido, como la hora de creación, el tipo de aprovisionamiento de capacidad, el tipo de aprovisionamiento de rendimiento, el número total de discos del almacenamiento compartido y los porcentajes de utilización de la capacidad, el rendimiento y las IOPS.

  6. En la sección Discos del grupo de almacenamiento, puede ver información sobre los discos creados en el grupo de almacenamiento.

  7. Opcional: Para obtener más información sobre el uso del grupo de almacenamiento, puede hacer clic en la pestaña Monitorización para ver gráficos de varias métricas del grupo de almacenamiento. Para obtener más información, consulta el artículo Monitorizar grupos de almacenamiento de Hyperdisk.

gcloud

Usa el comando gcloud compute storage-pools describe para ver los detalles de un grupo de almacenamiento.

gcloud compute storage-pools describe STORAGE_POOL_NAME  \
    [--zone=ZONE]

Haz los cambios siguientes:

  • STORAGE_POOL_NAME: el nombre único del grupo de almacenamiento.
  • ZONE: opcional. La zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a.

REST

Para obtener detalles sobre un grupo de almacenamiento, crea una solicitud GET con el método storagePools.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Haz los cambios siguientes:

  • PROJECT_ID: ID del proyecto que contiene el grupo de almacenamiento
  • ZONE: la zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a
  • STORAGE_POOL_NAME: el nombre del grupo de almacenamiento

Actualizar la capacidad aprovisionada, las IOPS o el rendimiento de un grupo de almacenamiento

Puedes aumentar o reducir la capacidad, las IOPS o el rendimiento aprovisionados de un grupo de almacenamiento. Para aumentar la capacidad, las IOPS o el rendimiento de un grupo de almacenamiento, debes tener cuota disponible para el proyecto y la región.

Consola

  1. Ve a la página Grupos de almacenamiento de la consola de Google Cloud .
    Ir a la página Grupos de almacenamiento

  2. En el campo Nombre, haz clic en el nombre del grupo de almacenamiento que quieras modificar.

    Se abrirá la página Gestionar grupo de almacenamiento.

  3. Haz clic en Editar.

    Se abrirá la página Editar grupo de almacenamiento.

  4. Opcional: En el campo Capacidad del grupo de almacenamiento, introduce el nuevo valor de la capacidad aprovisionada del grupo. El nuevo valor debe ser de al menos 1 TiB y de un máximo de 100 TiB más o menos que el valor actual. El tamaño mínimo no puede ser inferior a 10 TiB y el máximo no puede ser superior a 1024 TiB.

  5. Opcional: En el campo Capacidad de procesamiento aprovisionada, introduce el nuevo valor de la capacidad de procesamiento aprovisionada.

  6. Opcional: En el caso de los grupos de almacenamiento de tipo Hyperdisk Balanced, en el campo IOPS aprovisionadas, introduzca el nuevo valor de las IOPS aprovisionadas.

  7. Haz clic en Guardar para actualizar el grupo de almacenamiento.

gcloud

Usa el comando gcloud compute storage-pools update para modificar un grupo de almacenamiento.

gcloud compute storage-pools update STORAGE_POOL_NAME  \
    --zone=ZONE   \
    --provisioned-capacity=POOL_SIZETiB   \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

Haz los cambios siguientes:

  • STORAGE_POOL_NAME: el nombre del grupo de almacenamiento.
  • ZONE: opcional: la zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a.
  • POOL_SIZE: opcional: capacidad aprovisionada del grupo de almacenamiento, en TiB.
  • IOPS: opcional: las IOPS aprovisionadas del grupo de almacenamiento. Solo puedes usar esta marca con los grupos de almacenamiento equilibrados de Hyperdisk.
  • THROUGHPUT: opcional: el rendimiento aprovisionado del grupo de almacenamiento, en MiB/s.
  • DESCRIPTION: cadena descriptiva opcional del grupo de almacenamiento.

REST

Para actualizar un grupo de almacenamiento, crea una solicitud PATCH con el método storagePools.update.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

{
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "SIZE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT"
}

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto
  • ZONE: la zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a.
  • STORAGE_POOL_NAME: el nombre del grupo de almacenamiento.
  • DESCRIPTION: opcional: campo de texto para describir el grupo de almacenamiento.
  • SIZE: opcional: capacidad aprovisionada del nuevo grupo de almacenamiento, en GiB.
  • IOPS: opcional: el nuevo valor de las IOPS aprovisionadas del grupo de almacenamiento. Solo puede especificar esta propiedad cuando el grupo de almacenamiento contenga discos de tipo hyperdisk-balanced.
  • THROUGHPUT: opcional: el nuevo valor del rendimiento aprovisionado del grupo de almacenamiento, especificado en MiB/s.

Eliminar un grupo de almacenamiento

Para eliminar o quitar un grupo de almacenamiento, primero debes eliminar todos los discos que contenga. Después, puedes usar la Google Cloud consola, la interfaz de línea de comandos de Google Cloud o REST para eliminar el grupo de almacenamiento.

La eliminación de un grupo de almacenamiento es irreversible. Sin embargo, al eliminar un grupo de almacenamiento, no se eliminan las copias de seguridad creadas a partir de los discos que se crearon en el grupo de almacenamiento. Debes eliminar las instantáneas por separado.

Consola

  1. Ve a la página Grupo de almacenamiento de la consola de Google Cloud .
    Ir a la página Grupo de almacenamiento

  2. En el campo Nombre, haga clic en el nombre del grupo de almacenamiento que quiera quitar.

    Se abrirá la página Gestionar grupo de almacenamiento.

  3. En la sección Discos del grupo de almacenamiento, compruebe que no haya ningún disco en la lista del grupo de almacenamiento.

  4. Haz clic en Eliminar grupo.

gcloud

Usa el comando gcloud compute storage-pools delete para eliminar un grupo de almacenamiento.

gcloud compute storage-pools delete STORAGE_POOL_NAME  \
    --zone=ZONE   \

Haz los cambios siguientes:

  • STORAGE_POOL_NAME: el nombre único del grupo de almacenamiento.
  • ZONE: opcional: la zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a.

REST

Para eliminar un grupo de almacenamiento, crea una solicitud DELETE para el método storagePools.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto
  • ZONE: la zona en la que se encuentra el grupo de almacenamiento. Por ejemplo, us-central1-a.
  • STORAGE_POOL_NAME: el nombre único del grupo de almacenamiento.

Siguientes pasos