Administra un grupo de almacenamiento de Hyperdisk

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

Antes de comenzar

  • Configura la autenticación si aún no lo hiciste. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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 proporcionas a la CLI de gcloud.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

Roles y permisos requeridos

Para obtener los permisos que necesitas a fin de administrar un grupo de almacenamiento, 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 pueda 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 de almacenamiento. 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 de almacenamiento:

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

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

Limitaciones

Ten en cuenta las siguientes limitaciones cuando administres grupos de almacenamiento de Hyperdisk:

  • Puedes cambiar la capacidad aprovisionada o el rendimiento aprovisionado de un grupo de almacenamiento como máximo dos veces en un período de 24 horas.
  • No puedes cambiar el modelo de aprovisionamiento de un grupo; 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 se permite mover discos dentro o fuera de un grupo de almacenamiento. Para mover un disco dentro o fuera de un grupo de almacenamiento, 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 de Persistent Disk para los discos en un grupo de almacenamiento.
  • 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.

Para obtener la lista completa de las limitaciones del grupo de almacenamiento de Hyperdisk, consulta Limitaciones de los grupos de almacenamiento.

Rangos de valor cuando modificas grupos de almacenamiento

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 los valores incrementales admitidos.

Si deseas obtener información detallada sobre los límites de aprovisionamiento de rendimiento, consulta Límites para los grupos de almacenamiento.

Enumera los grupos de almacenamiento de un proyecto

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

Console

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

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

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

gcloud

Para enumerar todos los grupos de almacenamiento 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 de almacenamiento creados dentro de un proyecto y una zona, crea una solicitud GET mediante 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 de almacenamiento, por ejemplo, us-central1-a.

Enumera los discos en un grupo de almacenamiento

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

Console

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

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

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

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

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

gcloud

Para enumerar los discos que se crearon 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]

Reemplaza lo siguiente:

  • 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 mediante 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 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 consola de Google Cloud, Google Cloud CLI o REST.

Console

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

  2. Para cada grupo de almacenamiento enumerado 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

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

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

  4. En las tarjetas 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 del grupo de almacenamiento.

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

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

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]

Reemplaza lo siguiente:

  • 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 recuperar detalles sobre un grupo de almacenamiento, crea una solicitud GET mediante 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: 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

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

Puedes aumentar o disminuir la capacidad aprovisionada, las IOPS o la capacidad de procesamiento de 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.

Console

  1. Ve a la página Grupos de almacenamiento en 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 deseas modificar.

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

  3. Haz clic en  Cambiar.

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

  4. Opcional: En el campo Capacidad del grupo de almacenamiento, ingresa el valor nuevo para la capacidad aprovisionada del grupo. El valor nuevo debe ser al menos 1 TiB y 100 TiB más o menos 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 1,024 TiB.

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

  6. Opcional: Para los grupos de almacenamiento de tipo Hyperdisk Balanced, en el campo IOPS aprovisionadas, ingresa el valor nuevo para 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

Reemplaza lo siguiente:

  • 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: La capacidad aprovisionada del grupo de almacenamiento, en TiB.
  • IOPS: Opcional: las IOPS aprovisionadas del grupo de almacenamiento. Puedes usar esta marca solo con grupos de almacenamiento de Hyperdisk Balanced.
  • THROUGHPUT: Opcional: Es la capacidad de procesamiento aprovisionada del grupo de almacenamiento, en MBps.
  • DESCRIPTION: Opcional: Es una cadena descriptiva para el grupo de almacenamiento.

REST

Para actualizar un grupo de almacenamiento, crea una solicitud PATCH mediante 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: el ID del proyecto
  • ZONE: Es 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: es un campo de texto para describir el grupo de almacenamiento.
  • SIZE: Opcional: la nueva capacidad aprovisionada del grupo de almacenamiento, en GiB.
  • IOPS: Opcional: el valor nuevo para las IOPS aprovisionadas por el grupo de almacenamiento. Solo puedes especificar esta propiedad cuando el grupo de almacenamiento contenga discos del tipo hyperdisk-balanced.
  • THROUGHPUT: Opcional: es el valor nuevo para la capacidad de procesamiento aprovisionada por el grupo de almacenamiento, especificado en MBps.

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, puedes usar la consola de Google Cloud, Google Cloud CLI o REST para borrar el grupo de almacenamiento.

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

Console

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

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

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

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

  4. Haz clic en Borrar grupo.

gcloud

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

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

Reemplaza lo siguiente:

  • 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

A fin de quitar 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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto
  • ZONE: Es 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.

Próximos pasos