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.
  

  Selecciona la pestaña para saber cómo planeas usar las muestras en esta página:

  Consola

  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 y, luego, inicializa la ejecución del siguiente comando:

     gcloud init

     Nota: Si ya instalaste la CLI de gcloud, asegúrate de que tienes la versión más reciente mediante la ejecución de gcloud components update.
  2. Configura una región y una zona predeterminadas.

  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.

  Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:

  gcloud init

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)

Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.

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 de un grupo de almacenamiento como máximo dos veces en un período de 24 horas.
• 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

La capacidad aprovisionada mínima para un grupo de almacenamiento es de 10 TiB y la capacidad máxima aprovisionada es de 1 PiB. Puedes cambiar la capacidad aprovisionada del grupo de almacenamiento en incrementos de 1 TiB.

Para conocer los límites de aprovisionamiento de rendimiento, consulta lo siguiente:

• Límites para el grupo de almacenamiento de capacidad de procesamiento de Hyperdisk
• Límites para el grupo de almacenamiento balanceado de hiperdiscos

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

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 la sección Configuración del grupo de almacenamiento, puedes ver propiedades adicionales del grupo de almacenamiento, como la hora de creación y el tipo de aprovisionamiento de capacidad.

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

Nota: 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 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

• Obtén más información sobre los grupos de almacenamiento.