Administra grupos de Hyperdisk

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

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:

    Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

    Console

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

    gcloud

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

      gcloud init

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

  • Configura una región y una zona predeterminadas.

    • REST

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

      Instala Google Cloud CLI.

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la 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 .

Roles y permisos requeridos

Para obtener los permisos que necesitas para administrar un grupo, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

  • Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1)
  • Para conectarte a una instancia de VM que puede ejecutarse como una cuenta de servicio: Usuario de cuenta de servicio (v1) (rol roles/iam.serviceAccountUser)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para administrar un grupo. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para administrar un grupo:

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

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

Limitaciones

Limitaciones para administrar grupos:

  • No puedes cambiar el modelo de aprovisionamiento de un grupo. Por ejemplo, no puedes cambiar un grupo de almacenamiento de capacidad estándar a un grupo de almacenamiento de capacidad avanzada ni un grupo de almacenamiento de rendimiento avanzado a un grupo de almacenamiento de rendimiento estándar.
  • No puedes mover discos dentro o fuera de un grupo. Para mover un disco dentro o fuera de un grupo, debes volver a crear el disco a partir de una instantánea. Para obtener más información, consulta Cambia el tipo de disco.
  • No puedes clonar, crear instantáneas inmediatas ni configurar la replicación asíncrona para los discos en un grupo.

Limitaciones específicas de los grupos de almacenamiento:

  • Puedes cambiar la capacidad aprovisionada o el rendimiento de un grupo de almacenamiento como máximo dos veces en un período de 24 horas.
  • Puedes borrar como máximo 5 grupos de almacenamiento por hora.
  • El comando de administración del grupo de almacenamiento se ejecuta de forma correcta o falla de inmediato, pero puede tardar hasta 5 minutos en completar la acción y hasta 30 minutos para que aparezcan los cambios.

Limitaciones específicas de los Exapools:

  • Debes comunicarte con tu equipo de cuentas para cambiar la capacidad, las IOPS o la capacidad de procesamiento aprovisionados de un Exapool.
  • Debes comunicarte con tu equipo de cuentas para borrar un Exapool.

Para obtener la lista completa de limitaciones, consulta Limitaciones de los grupos de almacenamiento y Limitaciones de los Exapools.

Rangos de valores cuando se modifican grupos

Cuando creas un grupo de almacenamiento, los valores nuevos de tamaño, IOPS y capacidad de procesamiento deben estar dentro de los límites del tipo de grupo de almacenamiento que modificas. Además, solo puedes especificar valores nuevos con valores incrementales admitidos.

Para conocer los límites detallados de aprovisionamiento de rendimiento, consulta Límites para grupos de almacenamiento y Límites de tamaño y rendimiento para Exapools.

Enumera los grupos de un proyecto

Para ver los grupos que se crearon en un proyecto, usa laGoogle Cloud consola, Google Cloud CLI o REST.

Console

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

  2. Selecciona la pestaña de Exapools o Storage Pools.

    En la página, se muestran los grupos creados dentro del proyecto seleccionado.

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

gcloud

Para enumerar todos los grupos creados dentro del 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 específica, puedes usar la marca --filter, por ejemplo:

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

REST

Para mostrar los grupos creados dentro de 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

Reemplaza lo siguiente:

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

Enumera los discos en un grupo

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

Console

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

  2. Selecciona la pestaña de Exapools o Storage Pools.

    En la página, se muestran los grupos creados dentro del proyecto seleccionado.

  3. En el campo Nombre, haz clic en el nombre del grupo que deseas ver.

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

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

gcloud

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

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

Reemplaza lo siguiente:

  • STORAGE_POOL_NAME: el nombre del grupo.
  • ZONE: Opcional Es la zona en la que se encuentra el grupo, por ejemplo, us-central1-a.

REST

Para enumerar los discos que usan un grupo, 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

Reemplaza lo siguiente:

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

Describe un grupo

Para ver los detalles de un grupo, puedes usar la Google Cloud consola, Google Cloud CLI o REST.

Console

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

  2. Selecciona la pestaña de Exapools o Storage Pools.

  3. Para cada grupo que aparece en la página, puedes ver la siguiente información:

    • Estado
    • Nombre
    • Ubicación
    • Tipo de grupo
    • Capacidad del grupo
    • Capacidad restante del grupo
    • IOPS del grupo
    • IOPS del grupo restantes
    • Cantidad de discos creados en el grupo

  4. En el campo Nombre, haz clic en el nombre del grupo que deseas ver.

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

  5. En los mosaicos de la parte superior de la página, puedes ver la capacidad aprovisionada y usada, y la capacidad de procesamiento y las IOPS aprovisionadas y usadas para el grupo.

  6. En la sección Configuración del grupo de almacenamiento, puedes ver propiedades adicionales del grupo, como la hora de creación, el tipo de aprovisionamiento de capacidad, el tipo de aprovisionamiento de rendimiento y el número total de discos en el grupo, así como los porcentajes de uso de capacidad, capacidad de procesamiento y también IOPS.

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

  8. Opcional: Para obtener información adicional sobre el uso del grupo, puedes hacer clic en la pestaña Monitoring para ver gráficos de varias métricas del grupo. Para obtener más información, consulta Supervisa grupos.

gcloud

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

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

Reemplaza lo siguiente:

  • STORAGE_POOL_NAME: Es el nombre único del grupo.
  • ZONE: Opcional Es la zona en la que se encuentra el grupo, por ejemplo, us-central1-a.

REST

Para recuperar detalles sobre un grupo, 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

Reemplaza lo siguiente:

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

Cómo modificar un grupo

Puedes aumentar o disminuir la capacidad aprovisionada, las IOPS o la capacidad de procesamiento de un grupo.

Cómo modificar un grupo de almacenamiento

Si deseas aumentar la capacidad, las IOPS o la capacidad de procesamiento de un grupo de almacenamiento, debes tener una cuota disponible para el proyecto y la región. Pueden pasar hasta 30 minutos antes de que se muestren los valores de aprovisionamiento nuevos para el grupo de almacenamiento.

Console

  1. Ve a la página Grupos de almacenamiento en la Google Cloud consola.
    Ir a la página Grupos de almacenamiento
  2. Selecciona la pestaña Grupos de almacenamiento.

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

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

  4. Haz clic en  Cambiar.

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

  5. Opcional: En el campo Capacidad del grupo de almacenamiento, ingresa el valor nuevo para la capacidad aprovisionada del grupo. El valor nuevo debe diferir del valor actual en al menos 1 TiB y no más de 100 TiB. El valor nuevo puede ser mayor o menor que el valor actual. El tamaño mínimo no puede ser inferior a 10 TiB y el tamaño máximo no puede ser de más de 5 PiB.

  6. Opcional: En el campo Capacidad de procesamiento aprovisionada, ingresa el valor nuevo para la capacidad de procesamiento aprovisionada.

  7. Opcional: Para los grupos de almacenamiento de Hyperdisk Balanced, en el campo IOPS aprovisionadas, ingresa el valor nuevo para las IOPS aprovisionadas.

  8. 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

Reemplaza lo siguiente:

  • STORAGE_POOL_NAME: el nombre del grupo.
  • ZONE: Opcional: Es la zona en la que se encuentra el grupo, por ejemplo, us-central1-a.
  • POOL_SIZE: Opcional: La capacidad aprovisionada del grupo, en TiB.
  • IOPS: Opcional: Las IOPS aprovisionadas del grupo. Puedes usar esta marca solo con grupos de almacenamiento de Hyperdisk Balanced.
  • THROUGHPUT: Opcional: Es la capacidad de procesamiento aprovisionada del grupo, en MiB/s.
  • DESCRIPTION: Opcional: Es una cadena descriptiva para el grupo.

REST

Para actualizar un grupo, 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"
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • ZONE: Es la zona en la que se encuentra el grupo, por ejemplo, us-central1-a.
  • STORAGE_POOL_NAME: el nombre del grupo.
  • DESCRIPTION: Opcional: Es un campo de texto para describir el grupo.
  • SIZE: Opcional: La nueva capacidad aprovisionada del grupo, en GiB.
  • IOPS: Opcional: Es el valor nuevo para las IOPS aprovisionadas por el grupo. Solo puedes especificar esta propiedad cuando el grupo contiene discos del tipo hyperdisk-balanced.
  • THROUGHPUT: Opcional: Es el valor nuevo para la capacidad de procesamiento aprovisionada del grupo, especificado en MiB/s.

Cómo modificar un Exapool

Para cambiar la capacidad, las IOPS o la capacidad de procesamiento aprovisionadas de un Exapool, comunícate con tu equipo de cuentas.

Borra un grupo

La eliminación de un grupo es irreversible. Sin embargo, si borras un grupo, no se borran las instantáneas creadas a partir de los discos que se crearon en el grupo. Debes borrar las instantáneas por separado.

Borra un grupo de almacenamiento

Para borrar o quitar un grupo de almacenamiento, primero debes borrar todos los discos dentro del grupo de almacenamiento. Luego, usa la Google Cloud consola, Google Cloud CLI o REST para borrar el grupo de almacenamiento.

Console

  1. Ve a la página Grupos de almacenamiento en la Google Cloud consola.
    Ir a la página Grupos de almacenamiento
  2. 1. Selecciona la pestaña Grupos de almacenamiento.

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

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

  4. En la sección Discos del grupo de almacenamiento, verifica que no haya discos enumerados para el grupo de almacenamiento.

  5. Haz clic en Borrar grupo.

gcloud

Usa el comando gcloud compute storage-pools delete para borrar un grupo.

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

Reemplaza lo siguiente:

  • STORAGE_POOL_NAME: Es el nombre único del grupo.
  • ZONE: Opcional: Es la zona en la que se encuentra el grupo, por ejemplo, us-central1-a.

REST

Para quitar un grupo, 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

Reemplaza lo siguiente:

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

Cómo borrar un Exapool

Para borrar un Exapool, comunícate con tu equipo de cuentas.

Próximos pasos