Se usó la API de Cloud Translation para traducir esta página.

Reubicar buckets

En esta página, se describe el proceso para cambiar la ubicación de los buckets. Para obtener información sobre la reubicación de bucket, consulta Reubicación de buckets.

Antes de comenzar

Antes de reubicar buckets, completa los siguientes pasos:

Configura Storage Intelligence.
Habilita la opción de borrar de forma no definitiva.
Verifica las cuotas y los límites para comprobar que la nueva ubicación tenga cuotas suficientes para admitir los datos del bucket.
Determina el tipo de reubicación del bucket para saber si se requiere tiempo de inactividad de escritura.
Quita las etiquetas de bucket existentes.
Si usas informes de inventario, guarda tus configuraciones.
Obtén los roles necesarios, que se describen en la siguiente sección.

Obtén las funciones necesarias

Para obtener los permisos que necesitas para reubicar buckets, pídele a tu administrador que te otorgue el rol de IAM Administrador de almacenamiento (roles/storage.admin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para reubicar buckets. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para cambiar la ubicación de los buckets:

Para reubicar un bucket, sigue estos pasos: storage.buckets.relocate
Para ver el estado de una operación de reubicación del bucket, haz lo siguiente: storage.bucketOperations.get
Para ver la lista de operaciones de reubicación de bucket de un proyecto, haz lo siguiente: storage.bucketOperations.list
Para cancelar una operación de reubicación de bucket, haz lo siguiente: storage.bucketOperations.cancel
Para ver los metadatos de un bucket durante las fases de ejecución de prueba y reubicación del bucket, haz lo siguiente: storage.buckets.get
Para obtener un objeto en un bucket que deseas reubicar, haz lo siguiente: storage.objects.get
Para enumerar los objetos en un bucket que deseas reubicar, haz lo siguiente: storage.objects.list

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

Reubicar buckets

En esta sección, se describe el proceso para cambiar la ubicación de los buckets de Cloud Storage.

Para reubicar un bucket, completa los siguientes pasos:

Prueba la reubicación del bucket con una ejecución de prueba (opcional)
Cómo iniciar el proceso de reubicación del bucket
Cómo iniciar el paso de sincronización final

Para obtener más información sobre estos pasos, consulta Información sobre el proceso de reubicación bucket buckets.

Prueba la reubicación del bucket con una ejecución de prueba (opcional)

Para minimizar los posibles problemas durante el proceso de reubicación del bucket, te recomendamos que realices una ejecución de prueba para probar el proceso de extremo a extremo. Una prueba de validación simula el proceso de reubicación del bucket sin mover datos, lo que te ayuda a detectar y resolver problemas de forma anticipada. La ejecución de prueba verifica las siguientes incompatibilidades:

Si bien una prueba no puede identificar todos los problemas posibles, ya que algunos solo pueden surgir durante la migración en vivo debido a factores como la disponibilidad de recursos en tiempo real, reduce el riesgo de enfrentar problemas que consumen mucho tiempo durante la reubicación real.

Console

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

Ir a Buckets
En la lista de buckets, haz clic en el nombre del bucket que deseas reubicar.
En la página de detalles del bucket haz clic en la pestaña Configuración.
En la sección Descripción general, haz clic en Editar junto al campo Ubicación.
En la página Relocate bucket, ingresa la nueva ubicación del bucket. Después de cada uno de los siguientes pasos, haz clic en Continuar para avanzar al siguiente paso:
1. En la sección Confirma el bucket que planeas reubicar, revisa el bucket y su ubicación.
2. En la sección Antes de continuar, revisa las configuraciones que impiden la reubicación. Si se aplica una restricción a tu bucket, considera el Servicio de transferencia de almacenamiento como una solución alternativa.
3. En la sección Elige dónde reubicar el bucket, haz lo siguiente:
  1. Selecciona un tipo de ubicación.
  2. Selecciona una ubicación en la que se almacenarán los datos de objetos de tu bucket.
    
    Según la ubicación de origen y destino, se te informará si se requiere un tiempo de inactividad de escritura. Para obtener información sobre los tipos de reubicación y tiempo de inactividad, consulta Tipos de reubicación.
4. En la sección Elige cómo deseas continuar, haz clic en Comenzar con una prueba de validación (recomendado). Una prueba de validación simula la reubicación para identificar posibles problemas sin mover datos.
5. Haz clic en Continuar.
Haz clic en Iniciar.
En el cuadro de diálogo de confirmación Comienza con una prueba de validación, revisa el mensaje que aparece y haz clic en Iniciar prueba de validación.

Después de iniciar una ejecución de prueba, se inicia una operación de larga duración. Puedes supervisar el progreso en la pestaña Operaciones de la página de detalles del bucket.

Línea de comandos

Para iniciar una prueba de validación, ejecuta el comando gcloud storage buckets relocate con la marca --dry-run:

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION --dry-run

Aquí:

BUCKET_NAME es el nombre del bucket que deseas reubicar.
LOCATION es la ubicación de destino del bucket.

Después de iniciar una ejecución de prueba, se inicia una operación de larga duración. Recibirás un ID de operación y una descripción de la operación. Haz un seguimiento del progreso y la finalización de la prueba de validación obteniendo los detalles de la operación de larga duración.

Si la prueba de validación revela algún problema, soluciónalo antes de continuar con el paso de reubicación.

API de JSON

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Crea un archivo JSON que contenga la configuración del bucket, que debe incluir los parámetros destinationLocation y validateOnly. Consulta la documentación de Buckets: relocate para obtener una lista completa de opciones de configuración. A continuación, se indican las opciones de configuración comunes que puedes incluir:
```
{
  "destinationLocation": "DESTINATION_LOCATION",
  "destinationCustomPlacementConfig": {
    "dataLocations": [
      LOCATIONS,
        ...
        ]
    },
  "validateOnly": "true"
  }
```
Aquí:
- DESTINATION_LOCATION es la ubicación de destino del bucket.
- LOCATIONS es una lista de códigos de ubicación que se usarán para la región doble configurable.
- validateOnly se establece en true para realizar una ejecución de prueba.
Usa cURL para llamar a la API de JSON:
```
curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/relocate"
```
Aquí:
- JSON_FILE_NAME es el nombre del archivo JSON que creaste.
- BUCKET_NAME es el nombre del bucket que deseas reubicar.
Después de iniciar una ejecución de prueba, se inicia una operación de larga duración. La ejecución de prueba se realiza correctamente cuando se cumplen las siguientes condiciones:
- La prueba de validación no informa ningún error.
- El recurso operations devuelve un valor de campo done de true.
```
{
"kind": "storage#operation",
"name": "projects/_/buckets/bucket/operations/operation_id",
"metadata": {
  "@type": OperationMetadataType*,
  metadata OperationMetadata*
},
"done": "true",
"response": {
      "@type": ResponseResourceType*,
      response ResponseResource*
    }
  }
```
  Si la prueba de validación revela algún problema, soluciónalo antes de continuar con el paso Inicia la reubicación.

Inicia la reubicación del bucket

Console

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

Ir a Buckets
En la lista de buckets, haz clic en el nombre del bucket que deseas reubicar.
En la página de detalles del bucket haz clic en la pestaña Configuración.
En la sección Descripción general, haz clic en Editar junto al campo Ubicación.
En la página Relocate bucket, ingresa la nueva ubicación del bucket. Después de cada uno de los siguientes pasos, haz clic en Continuar para avanzar al siguiente paso:
1. En la sección Confirma el bucket que planeas reubicar, revisa el bucket y su ubicación.
2. En la sección Antes de continuar, revisa las configuraciones que impiden la reubicación. Si se aplica una restricción a tu bucket, considera el Servicio de transferencia de almacenamiento como una solución alternativa.
3. En la sección Elige dónde reubicar el bucket, haz lo siguiente:
  1. Selecciona un tipo de ubicación.
  2. Selecciona una ubicación en la que se almacenarán los datos de objetos de tu bucket.
    
    Según la ubicación de origen y destino, se te informará si se requiere un tiempo de inactividad de escritura. Para obtener información sobre los tipos de reubicación y tiempo de inactividad, consulta Tipos de reubicación.
4. En la sección Elige cómo deseas continuar, haz clic en Trasladar ahora.
5. Haz clic en Continuar.
Para iniciar el proceso de reubicación, haz clic en Iniciar.
En el diálogo de confirmación Relocate now, revisa el mensaje que aparece y haz clic en Start relocate.

Después de iniciar el proceso de reubicación, se inicia una operación de larga duración. Puedes supervisar el progreso en la pestaña Operaciones de la página detalles del bucket.

Línea de comandos

Para iniciar la reubicación del bucket, ejecuta el comando gcloud storage buckets relocate:

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION

Aquí:

BUCKET_NAME es el nombre del bucket que deseas reubicar.
LOCATION es la ubicación de destino del bucket.

Nota: Cuando crees una región doble configurable, debes establecer la marca --location como el código de ubicación asociado con las regiones subyacentes y debes usar la marca --placement con un par de regiones válido. Por ejemplo: --location=US --placement=US-CENTRAL1,US-EAST1

API de JSON

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Crea un archivo JSON que contenga la configuración del bucket. Consulta la documentación de Buckets: relocate para obtener una lista completa de opciones de configuración. A continuación, se indican las opciones de configuración comunes que puedes incluir:
```
{
  "destinationLocation": "DESTINATION_LOCATION",
  "destinationCustomPlacementConfig": {
  "dataLocations": [
    LOCATIONS,
    ...
    ]
    },
  "validateOnly": "false"
  }
```
Aquí:
- DESTINATION_LOCATION es la ubicación de destino del bucket.
- LOCATIONS es una lista de códigos de ubicación que se usarán para la región doble configurable.
- validateOnly se establece en false para iniciar la reubicación del bucket.

Usa cURL para llamar a la API de JSON:

curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/relocate"

Aquí:

JSON_FILE_NAME es el nombre del archivo JSON que creaste.
BUCKET_NAME es el nombre del bucket que deseas reubicar.

Supervisa el proceso de reubicación

Console

Para supervisar el progreso de la simulación o el proceso de reubicación, completa los siguientes pasos:

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

Ir a Buckets
En la lista de buckets, haz clic en el nombre del bucket que deseas reubicar.
En la página Detalles del bucket, haz clic en la pestaña Operaciones.
En la lista de operaciones de bucket que aparece, haz clic en la operación de simulación o de reubicación para ver sus detalles.

En la página de detalles de la operación, se muestran el resumen de la reubicación, las métricas clave y un resumen de los errores.

Línea de comandos

Después de iniciar la reubicación de un bucket, se inicia una operación de larga duración. Recibirás un ID de operación y una descripción de la operación. Haz un seguimiento del progreso y la finalización del proceso de reubicación obteniendo los detalles de la operación de larga duración.

API de JSON

La reubicación del bucket es una operación de larga duración que requiere supervisión. Para verificar el estado del proceso, revisa periódicamente los detalles de la operación de larga duración. Para obtener información sobre cómo verificar el estado del proceso de reubicación, consulta Obtén detalles de una operación de larga duración.

En el siguiente ejemplo, se muestra el resultado que genera una operación de reubicación:

  done: false
  kind: storage#operation
  metadata:
  '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketMetadata
  commonMetadata:
    createTime: '2024-10-21T04:26:59.666Z
    endTime: '2024-12-29T23:39:53.340Z'
    progressPercent: 99
    requestedCancellation: false
    type: relocate-bucket
    updateTime: '2024-10-21T04:27:03.2892'
  destinationLocation: US-CENTRAL1
  finalizationState: 'READY'
  progress:
    byteProgressPercent: 100
    discoveredBytes: 200
    remainingBytes: 0
    discoveredObjectCount: 10
    remainingObjectCount: 8
    objectProgressPercent: 100
    discoveredSyncCount: 8
    remainingSyncCount: 0
    syncProgressPercent: 100
  relocationState: SYNCING
  sourceLocation: US
  validateOnly: false
  estimatedWriteDowntimeDuration: '7200s'
  writeDowntimeExpireTime: '2024-12-30T10:34:01.786Z'
  name: projects//buckets/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w
  response:
    '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketResponse
      selfLink: https://storage.googleusercontent.com/storage/v1_ds/b/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w

En la siguiente tabla, se proporciona información sobre los campos clave en el resultado que genera la operación de reubicación:

Nombre del campo	Descripción	Valores posibles
`done`	Indica que se completó la operación de reubicación del bucket.	`true`, `false`
`kind`	Indica que este recurso representa una operación de almacenamiento.
`metadata`	Proporciona información sobre la operación.
`metadata.@type`	Indica el tipo de operación como reubicación del bucket.
`metadata.commonMetadata`	Son los metadatos comunes a todas las operaciones.
`metadata.commonMetadata.createTime`	Es la fecha y hora en que se creó la operación de larga duración.
`metadata.commonMetadata.endTime`	Es la hora en la que finalizó la operación de larga duración.
`metadata.commonMetadata.progressPercent`	Es el progreso estimado de la operación de larga duración, expresado en porcentaje.	Entre `0` y `100`%. Un valor de `-1` significa que el progreso es desconocido o no aplicable.
`metadata.commonMetadata.requestedCancellation`	Indica si el usuario solicitó la cancelación de la operación de larga duración.	`true`, `false`
`metadata.commonMetadata.type`	Indica el tipo de operación de larga duración.
`metadata.commonMetadata.updateTime`	Es la hora en la que se actualizó por última vez la operación de larga duración.
`metadata.destinationLocation`	Es la ubicación de destino del bucket.
`metadata.finalizationState`	Indica la disponibilidad para iniciar el paso de sincronización final.	`READY`: Indica que puedes iniciar el paso de sincronización final. Sin embargo, te recomendamos que esperes hasta que el valor del campo `progressPercent` alcance `99`. `WAITING_ON_SYNC`: Indica que no puedes iniciar el paso de sincronización final. `NOT_REQUIRED`: Indica que el paso de sincronización final no es necesario para este bucket y que puedes omitirlo. `BLOCKED_ON_ERRORS`: Indica que el paso de finalización se pausó temporalmente debido a errores. Deberás resolver los errores para continuar con el paso. `RUNNING`: Indica que el paso de finalización está en curso. `FINALIZED`: Indica que el paso de finalización se completó correctamente.
`metadata.progress`	Son los detalles del progreso de la operación de reubicación.
`metadata.progress.byteProgressPercent`	Progreso de los bytes copiados en porcentaje.	Entre `0` y `100`%. Un valor de `-1` significa que el progreso es desconocido o no aplicable.
`metadata.progress.discoveredBytes`	Cantidad de bytes descubiertos en el bucket de origen.
`metadata.progress.discoveredObjectCount`	Cantidad de objetos descubiertos en el bucket de origen.
`metadata.progress.discoveredSyncCount`	Cantidad de actualizaciones de metadatos de objetos descubiertas en el bucket de origen.
`metadata.progress.objectProgressPercent`	Es el progreso de los objetos copiados en porcentaje.	Entre `0` y `100`%. Un valor de `-1` significa que el progreso es desconocido o no aplicable.
`metadata.progress.remainingBytes`	Cantidad de bytes restantes que se deben copiar del bucket de origen al bucket de destino.
`metadata.progress.remainingObjectCount`	Cantidad de objetos que aún se deben copiar del bucket de origen al bucket de destino.
`metadata.progress.remainingSyncCount`	Cantidad de actualizaciones de metadatos de objetos restantes que se deben sincronizar.
`metadata.progress.syncProgressPercent`	Es el progreso de las actualizaciones de metadatos de objetos que se sincronizarán, expresado en porcentaje.	Entre `0` y `100`%. Un valor de `-1` significa que el progreso es desconocido o no aplicable.
`metadata.relocationState`	Es el estado general de la operación de reubicación del bucket.	`SYNCING`: Indica que el paso de reubicación del bucket está copiando objetos de forma activa del bucket de origen al bucket de destino. `FINALIZING`: Indica que se inició el paso de finalización. `FAILED`: Indica que el paso de reubicación del bucket encontró un error y no se completó correctamente. `SUCCEEDED`: Indica que el paso de reubicación del bucket se completó correctamente. `CANCELLED`: Indica que se canceló el paso de reubicación del bucket.
`metadata.sourceLocation`	Es la ubicación de origen del bucket.
`metadata.validateOnly`	Indica si se inició una prueba de validación de la reubicación del bucket.	`true`, `false`
`metadata.estimatedWriteDowntimeDuration`	Es la duración estimada del tiempo de inactividad de escritura, que se propaga una vez que `finalizationState` es `READY`.	El valor mínimo es `7200s`.
`metadata.writeDowntimeExpireTime`	Es la fecha y hora en que vence el tiempo de inactividad de escritura.
`name`	Es el identificador único de esta operación de reubicación. Formato: `projects/_/buckets/bucket-name/operations/operation-id`
`response`	Es la respuesta de la operación.
`response.@type`	Es el tipo de respuesta.
`selfLink`	Es un vínculo a esta operación.

Nota: metadata.commonMetadata.progressPercent muestra el nivel general de completitud de la operación de larga duración. Alcanza el 100% cuando se completan todos los pasos. Este es el único indicador confiable de éxito completo. Otros indicadores de progreso muestran el movimiento de bytes, objetos y metadatos. Estos pueden alcanzar el 100% antes que metadata.commonMetadata.progressPercent. Después de que se mueven los bytes, los objetos y los metadatos, la reubicación del bucket finaliza los pasos finales y, luego, se actualiza metadata.commonMetadata.progressPercent a 100%.

Si tienes problemas cuando interactúas con otras funciones de Cloud Storage, consulta Limitaciones.

Inicia el paso de sincronización final

En el caso de las reubicaciones que requieren un tiempo de inactividad de escritura, deberás iniciar la sincronización final. El paso de sincronización final implica un período en el que no puedes realizar operaciones de escritura en el bucket. Te recomendamos que programes el paso de sincronización final en un momento que minimice las interrupciones en tus aplicaciones.

Console

Para iniciar el paso de sincronización final, completa los siguientes pasos:

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

Ir a Buckets
En la lista de buckets, haz clic en el nombre del bucket que deseas reubicar.
En la página Detalles del bucket, haz clic en la pestaña Operaciones.
En la lista de operaciones del bucket, haz clic en la operación de reubicación para ver la página de detalles de la operación. En la página de detalles de la operación, cuando la copia de datos esté completa en al menos un 99%, aparecerá una barra de mensajes que indicará que es el momento óptimo para iniciar la sincronización final.
Opcional: Para establecer el tiempo de inactividad máximo permitido de escritura, haz clic en Establecer el tiempo de inactividad máximo permitido (TTL) y especifica la duración máxima del tiempo de inactividad.
Haz clic en Iniciar sincronización final.
En el diálogo de confirmación que aparece, haz clic en Iniciar para comenzar la sincronización final.

En la página de detalles de la operación, se muestran el resumen de la reubicación, las métricas clave y un resumen de los errores.

Línea de comandos

Antes de continuar, confirma que el bucket esté completamente preparado. Para ello, verifica el valor de finalizationState en el resultado del paso Inicia la reubicación del bucket.

Cuando el valor de finalizationState sea READY, ejecuta el comando gcloud storage buckets relocate para iniciar la sincronización final:

gcloud storage buckets relocate --finalize --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Aquí:

BUCKET_NAME es el nombre del bucket que deseas reubicar.
OPERATION_ID es el ID de la operación de larga duración de reubicación del bucket, que se muestra en la respuesta de los métodos a los que llamas. Por ejemplo, la siguiente respuesta se muestra cuando se llama a gcloud storage operations list y el ID de la operación de larga duración es AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74.

 `name: projects/_/buckets/my-bucket/operations/AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74`

Establece la marca ttl para tener un mayor control sobre el proceso de reubicación. Por ejemplo:

gcloud storage buckets relocate --finalize --ttl TTL_DURATION --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Aquí:

TTL_DURATION es el tiempo de actividad (TTL) para la fase de inactividad de escritura durante un proceso de reubicación. Se expresa como una cadena, por ejemplo, 12h para 12 horas. El parámetro TTL_DURATION determina la duración máxima permitida para la fase de inactividad de escritura. Si el tiempo de inactividad de escritura supera este límite, el proceso de reubicación volverá automáticamente al paso de reubicación del bucket y se volverán a habilitar las operaciones de escritura en el bucket. El valor debe estar dentro del rango de 6h (6 horas) a 48h (48 horas). Si no se especifica, el valor predeterminado es 12h (12 horas).

API de JSON

Antes de continuar, confirma que el bucket esté completamente preparado. Para ello, verifica el valor de finalizationState en el resultado del paso de reubicación del bucket. El valor de finalizationState debe ser READY para continuar.

Si inicias el paso de sincronización final antes de tiempo, el comando devolverá un mensaje de error The relocate bucket operation is not ready to advance to finalization running state, pero el proceso de reubicación continuará.

Te recomendamos que esperes hasta que el valor de progressPercent sea 99 antes de iniciar el paso de sincronización final.

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Crea un archivo JSON que contenga la configuración para la reubicación del bucket. Consulta la documentación de Buckets: advanceRelocateBucket para obtener una lista completa de opciones de configuración. A continuación, se indican las opciones de configuración comunes que puedes incluir:
```
{
"expireTime": "EXPIRE_TIME",
"ttl": "TTL_DURATION"
}
```
Aquí:
- EXPIRE_TIME es la hora en que vence el tiempo de inactividad de escritura.
- TTL_DURATION es el tiempo de actividad (TTL) para la fase de inactividad de escritura durante un proceso de reubicación. Se expresa como una cadena, por ejemplo, 12h para 12 horas. El parámetro TTL_DURATION determina la duración máxima permitida para la fase de inactividad de escritura. Si el tiempo de inactividad de escritura supera este límite, el proceso de reubicación volverá automáticamente al paso de reubicación del bucket y se volverán a habilitar las operaciones de escritura en el bucket. El valor debe estar dentro del rango de 6h (6 horas) a 48h (48 horas). Si no se especifica, el valor predeterminado es 12h (12 horas).
Usa cURL para llamar a la API de JSON:
```
curl -X POST --data-binary @JSON_FILE_NAME \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
 "https://storage.googleapis.com/storage/v1/b/bucket/BUCKET_NAME/operations/OPERATION_ID/advanceRelocateBucket"
```
Aquí:
- JSON_FILE_NAME es el nombre del archivo JSON que creaste.
- BUCKET_NAME es el nombre del bucket que deseas reubicar.
- OPERATION_ID es el ID de la operación de larga duración que inició la reubicación del bucket. Para obtener la lista de IDs de operaciones de larga duración de un bucket, consulta Operations: list.

Una vez que se reubica un bucket correctamente, no puedes iniciar otra reubicación para el mismo bucket durante un período de 14 días.

Valida el proceso de reubicación del bucket

Después de iniciar una reubicación, verifica que se haya completado correctamente. En esta sección, se proporciona orientación para confirmar la transferencia correcta de datos.

Valida el éxito del proceso de reubicación con los siguientes métodos:

Sondea operaciones de larga duración: La reubicación de buckets es una operación de larga duración. Puedes sondear la operación de larga duración con operation id para supervisar su progreso y confirmar que se completó correctamente verificando el estado success. Esto implica consultar periódicamente el estado de la operación hasta que alcance un estado final. Para obtener información sobre cómo supervisar operaciones de larga duración, consulta Usa operaciones de larga duración en Cloud Storage.
Analiza las entradas de los Registros de auditoría de Cloud: Los Registros de auditoría de Cloud proporcionan un registro detallado de los eventos y las operaciones en tu entorno de Google Cloud . Puedes analizar las entradas de los Registros de auditoría de Cloud asociadas con la reubicación para validar su éxito. Analiza los registros para detectar errores, advertencias o comportamientos inesperados que puedan indicar problemas durante la transferencia. Para obtener información sobre cómo ver los registros de Registros de auditoría de Cloud, consulta Visualiza los registros de auditoría.

Las siguientes entradas de registro te ayudan a determinar si la migración se realizó correctamente o no:
- Reubicación correcta: Relocate bucket succeeded. All existing objects are now in the new placement configuration.
- No se pudo realizar la reubicación: Relocate bucket has failed. Bucket location remains unchanged.
Con las notificaciones de Pub/Sub, también puedes configurar alertas que te notifiquen cuando el evento específico de éxito o falla aparezca en los registros. Para obtener información sobre cómo configurar las notificaciones de Pub/Sub, consulta Configura las notificaciones de Pub/Sub para Cloud Storage.

Completa las tareas posteriores a la reubicación del bucket

Después de que hayas reubicado correctamente tu bucket, completa los siguientes pasos:

Opcional: Restaura los controles de acceso basados en etiquetas en tu bucket.
Las configuraciones existentes de los informes de inventario no se conservan durante el proceso de reubicación, por lo que deberás volver a crearlas de forma manual. Para obtener información sobre cómo crear una configuración de informes de inventario, consulta Crea una configuración de informes de inventario.
Actualiza tus configuraciones de infraestructura como código, como Terraform y el conector de configuración de Google Kubernetes Engine, para especificar la nueva ubicación del bucket.
Los extremos regionales están vinculados a ubicaciones específicas, por lo que deberás modificar el código de tu aplicación para que refleje el nuevo extremo.

Cómo controlar las operaciones de reubicación de bucket fallidas

Ten en cuenta los siguientes factores antes de controlar las operaciones de reubicación de bucket fallidas:

Si falla la reubicación de un bucket, es posible que queden recursos obsoletos, como archivos temporales o copias de datos incompletas, en el destino. Debes esperar entre 7 y 14 días antes de iniciar otra reubicación del bucket en el mismo destino. Puedes iniciar la reubicación de un bucket a otro destino de inmediato.
Si la ubicación de destino no es la óptima para tus datos, es posible que desees revertir el cambio de ubicación. Sin embargo, no puedes iniciar una reubicación de inmediato. Se requiere un período de espera de hasta 14 días antes de que puedas volver a iniciar el proceso de reubicación para mantener la estabilidad y evitar conflictos de datos.

¿Qué sigue?

Obtén más información sobre la reubicación de buckets.

Reubicar buckets Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Obtén las funciones necesarias

Permisos necesarios

Reubicar buckets

Prueba la reubicación del bucket con una ejecución de prueba (opcional)

Console

Línea de comandos

API de JSON

Inicia la reubicación del bucket

Console

Línea de comandos

API de JSON

Supervisa el proceso de reubicación

Console

Línea de comandos

API de JSON

Inicia el paso de sincronización final

Console

Línea de comandos

API de JSON

Valida el proceso de reubicación del bucket

Completa las tareas posteriores a la reubicación del bucket

Cómo controlar las operaciones de reubicación de bucket fallidas

¿Qué sigue?

Reubicar buckets