Questa pagina è stata tradotta dall'API Cloud Translation.

Sposta bucket

Questa pagina descrive la procedura per spostare i bucket da una località a un'altra. Per informazioni sullo spostamento dei bucket, vedi Spostamento dei bucket.

Prima di iniziare

Prima di poter spostare i bucket, completa i seguenti passaggi:

Configura Storage Intelligence.
Abilita l'eliminazione temporanea.
Controlla le quote e i limiti per verificare che la nuova località disponga di quote sufficienti per ospitare i dati del bucket.
Determina il tipo di spostamento del bucket per capire se è necessario un tempo di inattività per la scrittura.
Rimuovi tutti i tag bucket esistenti.
Se utilizzi i report sull'inventario, salva le configurazioni.
Ottieni i ruoli richiesti, descritti nella sezione seguente.

Ottenere i ruoli richiesti

Per ottenere le autorizzazioni necessarie per trasferire i bucket, chiedi all'amministratore di concederti il ruolo IAM Storage Admin (roles/storage.admin) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per riassegnare i bucket. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per spostare i bucket sono necessarie le seguenti autorizzazioni:

Per spostare un bucket: storage.buckets.relocate
Per visualizzare lo stato di un'operazione di riposizionamento del bucket: storage.bucketOperations.get
Per visualizzare l'elenco delle operazioni di riposizionamento dei bucket per un progetto: storage.bucketOperations.list
Per annullare un'operazione di riposizionamento del bucket: storage.bucketOperations.cancel
Per visualizzare i metadati di un bucket durante le fasi di prova e spostamento del bucket: storage.buckets.get
Per ottenere un oggetto in un bucket che vuoi trasferire: storage.objects.get
Per elencare gli oggetti in un bucket che vuoi trasferire: storage.objects.list

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Sposta bucket

Questa sezione descrive il processo di trasferimento dei bucket Cloud Storage da una località a un'altra.

Per spostare un bucket, completa i seguenti passaggi:

(Facoltativo) Testa il trasferimento del bucket con un dry run
Avviare la procedura di trasferimento del bucket
Avviare il passaggio di sincronizzazione finale

Per saperne di più su questi passaggi, consulta Informazioni sulla procedura di trasferimento del bucket.

(Facoltativo) Testa lo spostamento del bucket con una dry run

Per ridurre al minimo i potenziali problemi durante la procedura di trasferimento del bucket, ti consigliamo di eseguire una prova dry run per testare la procedura end-to-end. Una prova dry run simula il processo di spostamento del bucket senza spostare i dati, aiutandoti a rilevare e risolvere i problemi in anticipo. La prova dry run verifica le seguenti incompatibilità:

Chiavi di crittografia gestite dal cliente (CMEK) o chiavi di crittografia fornite dal cliente (CSEK)
Criteri di conservazione bloccati
Oggetti con blocchi temporanei
Caricamenti multiparte

Anche se una prova generale non può identificare ogni possibile problema, in quanto alcuni potrebbero emergere solo durante la migrazione live a causa di fattori come la disponibilità di risorse in tempo reale, riduce il rischio di riscontrare problemi che richiedono molto tempo durante il trasferimento effettivo.

Console

Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.

Vai a Bucket
Nell'elenco dei bucket, fai clic sul nome del bucket da ricollocare.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Nella sezione Panoramica, fai clic su Modifica accanto al campo Posizione.
Nella pagina Rilocazione bucket, inserisci la nuova posizione del bucket. Dopo ogni passaggio riportato di seguito, fai clic su Continua per passare al passaggio successivo:
1. Nella sezione Conferma il bucket che prevedi di spostare, controlla il bucket e la sua posizione.
2. Nella sezione Prima di continuare, esamina le configurazioni che bloccano il trasferimento. Se una limitazione si applica al tuo bucket, valuta la possibilità di utilizzare Storage Transfer Service come soluzione alternativa.
3. Nella sezione Scegli dove spostare il bucket, segui questi passaggi:
  1. Seleziona un tipo di località.
  2. Seleziona una posizione in cui verranno archiviati i dati degli oggetti all'interno del bucket.
    
    In base alla posizione di origine e di destinazione, ti verrà comunicato se è necessario un tempo di inattività per la scrittura. Per informazioni sui tipi di spostamento e sul tempo di inattività, vedi Tipi di spostamento.
4. Nella sezione Scegli come procedere, fai clic su Inizia con un dry run (opzione consigliata). Un test dry run simula il trasferimento per identificare potenziali problemi senza spostare i dati.
5. Fai clic su Continua.
Fai clic su Avvia.
Nella finestra di dialogo di conferma Inizia con un test dry run, esamina il messaggio visualizzato e fai clic su Avvia test dry run.

Dopo aver avviato un test dry run, viene avviata un'operazione a lunga esecuzione. Puoi monitorare l'avanzamento nella scheda Operazioni della pagina Dettagli bucket.

Riga di comando

Per avviare una prova dry run, esegui il comando gcloud storage buckets relocate con il flag --dry-run:

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

Dove:

BUCKET_NAME è il nome del bucket che vuoi trasferire.
LOCATION è la posizione di destinazione del bucket.

Dopo aver avviato un test dry run, viene avviata un'operazione a lunga esecuzione. Riceverai un ID operazione e una descrizione dell'operazione. Monitora l'avanzamento e il completamento del dry run ottenendo i dettagli dell'operazione a lunga esecuzione.

Se il test dry run rivela problemi, risolvili prima di procedere con il passaggio di trasferimento.

API JSON

Avere gcloud CLI installato e inizializzato , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Crea un file JSON contenente le impostazioni del bucket, che deve includere i parametri destinationLocation e validateOnly. Consulta la documentazione Buckets: relocate per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni comuni da includere:
```
{
  "destinationLocation": "DESTINATION_LOCATION",
  "destinationCustomPlacementConfig": {
    "dataLocations": [
      LOCATIONS,
        ...
        ]
    },
  "validateOnly": "true"
  }
```
Dove:
- DESTINATION_LOCATION è la posizione di destinazione del bucket.
- LOCATIONS è un elenco di codici di località da utilizzare per la doppia regione configurabile.
- validateOnly è impostato su true per eseguire un dry run.
Utilizza cURL per chiamare l'API 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"
```
Dove:
- JSON_FILE_NAME è il nome del file JSON che hai creato.
- BUCKET_NAME è il nome del bucket che vuoi trasferire.
Dopo aver avviato un test dry run, viene avviata un'operazione a lunga esecuzione. La prova dry run ha esito positivo quando sono soddisfatte le seguenti condizioni:
- La prova non segnala errori.
- La risorsa operations restituisce un valore del campo done pari a true.
```
{
"kind": "storage#operation",
"name": "projects/_/buckets/bucket/operations/operation_id",
"metadata": {
  "@type": OperationMetadataType*,
  metadata OperationMetadata*
},
"done": "true",
"response": {
      "@type": ResponseResourceType*,
      response ResponseResource*
    }
  }
```
  Se la prova generale rivela problemi, risolvili prima di procedere con il passaggio Avvia il trasferimento.

Avvia lo spostamento del bucket

Console

Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.

Vai a Bucket
Nell'elenco dei bucket, fai clic sul nome del bucket da ricollocare.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Nella sezione Panoramica, fai clic su Modifica accanto al campo Posizione.
Nella pagina Rilocazione bucket, inserisci la nuova posizione del bucket. Dopo ogni passaggio riportato di seguito, fai clic su Continua per passare al passaggio successivo:
1. Nella sezione Conferma il bucket che prevedi di spostare, controlla il bucket e la sua posizione.
2. Nella sezione Prima di continuare, esamina le configurazioni che bloccano il trasferimento. Se una limitazione si applica al tuo bucket, valuta la possibilità di utilizzare Storage Transfer Service come soluzione alternativa.
3. Nella sezione Scegli dove spostare il bucket, segui questi passaggi:
  1. Seleziona un tipo di località.
  2. Seleziona una posizione in cui verranno archiviati i dati degli oggetti all'interno del bucket.
    
    In base alla posizione di origine e di destinazione, ti verrà comunicato se è necessario un tempo di inattività per la scrittura. Per informazioni sui tipi di spostamento e sul tempo di inattività, vedi Tipi di spostamento.
4. Nella sezione Scegli come procedere, fai clic su Sposta ora.
5. Fai clic su Continua.
Per avviare la procedura di trasferimento, fai clic su Avvia.
Nella finestra di dialogo di conferma Trasferisci ora, controlla il messaggio visualizzato e fai clic su Avvia trasferimento.

Dopo aver avviato la procedura di trasferimento, viene avviata un'operazione a lunga esecuzione. Puoi monitorare l'avanzamento nella scheda Operazioni della pagina Dettagli bucket.

Riga di comando

Per avviare lo spostamento del bucket, esegui il comando gcloud storage buckets relocate:

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

Dove:

BUCKET_NAME è il nome del bucket che vuoi trasferire.
LOCATION è la posizione di destinazione del bucket.

Nota: quando crei una doppia regione configurabile, devi impostare il flag --location sul codice di località associato alle regioni sottostanti e devi utilizzare il flag --placement con una coppia di regioni valida. Ad esempio, --location=US --placement=US-CENTRAL1,US-EAST1

API JSON

Avere gcloud CLI installato e inizializzato , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Crea un file JSON contenente le impostazioni del bucket. Consulta la documentazione Buckets: relocate per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni comuni da includere:
```
{
  "destinationLocation": "DESTINATION_LOCATION",
  "destinationCustomPlacementConfig": {
  "dataLocations": [
    LOCATIONS,
    ...
    ]
    },
  "validateOnly": "false"
  }
```
Dove:
- DESTINATION_LOCATION è la posizione di destinazione del bucket.
- LOCATIONS è un elenco di codici di località da utilizzare per la doppia regione configurabile.
- validateOnly è impostato su false per avviare lo spostamento del bucket.

Utilizza cURL per chiamare l'API 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"

Dove:

JSON_FILE_NAME è il nome del file JSON che hai creato.
BUCKET_NAME è il nome del bucket che vuoi trasferire.

Monitorare la procedura di trasferimento

Console

Per monitorare l'avanzamento della prova generale o della procedura di trasferimento, completa i seguenti passaggi:

Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.

Vai a Bucket
Nell'elenco dei bucket, fai clic sul nome del bucket che stai spostando.
Nella pagina Dettagli bucket, fai clic sulla scheda Operazioni.
Nell'elenco delle operazioni sui bucket visualizzato, fai clic sull'operazione di prova o di trasferimento per visualizzarne i dettagli.

La pagina dei dettagli dell'operazione mostra il riepilogo del trasferimento, le metriche chiave e un riepilogo degli errori.

Riga di comando

Dopo aver avviato lo spostamento di un bucket, viene avviata un'operazione a lunga esecuzione. Riceverai un ID operazione e una descrizione dell'operazione. Monitora l'avanzamento e il completamento della procedura di trasferimento ottenendo i dettagli dell'operazione a lunga esecuzione.

API JSON

Il trasferimento del bucket è un'operazione a lunga esecuzione che richiede il monitoraggio. Per controllare lo stato della procedura, esamina regolarmente i dettagli dell'operazione a lunga esecuzione. Per informazioni su come controllare lo stato del processo di trasferimento, vedi Visualizzare i dettagli di un'operazione a lunga esecuzione.

L'esempio seguente mostra l'output generato da un'operazione di trasferimento:

  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

La seguente tabella fornisce informazioni sui campi chiave nell'output generato dall'operazione di ricollocamento:

Nome campo	Descrizione	Valori possibili
`done`	Indica il completamento dell'operazione di riposizionamento del bucket.	`true`, `false`
`kind`	Indica che questa risorsa rappresenta un'operazione di archiviazione.
`metadata`	Fornisce informazioni sull'operazione.
`metadata.@type`	Indica il tipo di operazione come riposizionamento del bucket.
`metadata.commonMetadata`	Metadati comuni a tutte le operazioni.
`metadata.commonMetadata.createTime`	L'ora in cui è stata creata l'operazione a lunga esecuzione.
`metadata.commonMetadata.endTime`	L'ora in cui è terminata l'operazione a lunga esecuzione.
`metadata.commonMetadata.progressPercent`	L'avanzamento stimato dell'operazione a lunga esecuzione, in percentuale.	Tra `0` e `100`%. Un valore di `-1` indica che lo stato di avanzamento è sconosciuto o non applicabile.
`metadata.commonMetadata.requestedCancellation`	Indica se l'utente ha richiesto l'annullamento dell'operazione a lunga esecuzione.	`true`, `false`
`metadata.commonMetadata.type`	Indica il tipo di operazione a lunga esecuzione.
`metadata.commonMetadata.updateTime`	L'ora dell'ultimo aggiornamento dell'operazione a lunga esecuzione.
`metadata.destinationLocation`	La posizione di destinazione del bucket.
`metadata.finalizationState`	Indica la preparazione per l'avvio del passaggio di sincronizzazione finale.	`READY`: indica che puoi avviare il passaggio di sincronizzazione finale. Tuttavia, ti consigliamo di attendere fino a quando il valore del campo `progressPercent` raggiunge `99`. `WAITING_ON_SYNC`: indica che non puoi avviare il passaggio di sincronizzazione finale. `NOT_REQUIRED`: indica che il passaggio di sincronizzazione finale non è necessario per questo bucket e puoi saltarlo. `BLOCKED_ON_ERRORS`: indica che il passaggio di finalizzazione è temporaneamente sospeso a causa di errori. Per procedere con il passaggio, dovrai risolvere gli errori. `RUNNING`: indica che il passaggio di finalizzazione è in corso. `FINALIZED`: indica che il passaggio di finalizzazione è stato completato correttamente.
`metadata.progress`	Dettagli sull'avanzamento dell'operazione di riposizionamento.
`metadata.progress.byteProgressPercent`	Avanzamento della copia dei byte in percentuale.	Tra `0` e `100`%. Un valore di `-1` indica che lo stato di avanzamento è sconosciuto o non applicabile.
`metadata.progress.discoveredBytes`	Numero di byte rilevati nel bucket di origine.
`metadata.progress.discoveredObjectCount`	Numero di oggetti rilevati nel bucket di origine.
`metadata.progress.discoveredSyncCount`	Numero di aggiornamenti dei metadati degli oggetti rilevati nel bucket di origine.
`metadata.progress.objectProgressPercent`	Avanzamento della copia degli oggetti in percentuale.	Tra `0` e `100`%. Un valore di `-1` indica che lo stato di avanzamento è sconosciuto o non applicabile.
`metadata.progress.remainingBytes`	Numero di byte rimanenti da copiare dal bucket di origine al bucket di destinazione.
`metadata.progress.remainingObjectCount`	Numero di oggetti rimanenti da copiare dal bucket di origine al bucket di destinazione.
`metadata.progress.remainingSyncCount`	Numero di aggiornamenti dei metadati degli oggetti rimanenti da sincronizzare.
`metadata.progress.syncProgressPercent`	Avanzamento degli aggiornamenti dei metadati degli oggetti da sincronizzare in percentuale.	Tra `0` e `100`%. Un valore di `-1` indica che lo stato di avanzamento è sconosciuto o non applicabile.
`metadata.relocationState`	Stato complessivo dell'operazione di riposizionamento del bucket.	`SYNCING`: indica che il passaggio di trasferimento del bucket sta copiando attivamente gli oggetti dal bucket di origine al bucket di destinazione. `FINALIZING`: indica che è stato avviato il passaggio di finalizzazione. `FAILED`: indica che il passaggio di spostamento del bucket ha rilevato un errore e non è stato completato correttamente. `SUCCEEDED`: indica che il passaggio di trasferimento del bucket è stato completato correttamente. `CANCELLED`: indica che il passaggio di trasferimento del bucket è stato annullato.
`metadata.sourceLocation`	La posizione di origine del bucket.
`metadata.validateOnly`	Indica se è stato avviato un dry run dello spostamento del bucket.	`true`, `false`
`metadata.estimatedWriteDowntimeDuration`	La durata stimata del tempo di inattività in scrittura; viene compilata una volta che `finalizationState` è `READY`.	Il valore minimo è `7200s`.
`metadata.writeDowntimeExpireTime`	L'ora in cui scade il tempo di inattività in scrittura.
`name`	L'identificatore univoco di questa operazione di riassegnazione. Formato: `projects/_/buckets/bucket-name/operations/operation-id`
`response`	La risposta dell'operazione.
`response.@type`	Il tipo di risposta.
`selfLink`	Un link a questa operazione.

Nota:la metadata.commonMetadata.progressPercent mostra il completamento complessivo dell'operazione a lunga esecuzione. Raggiunge il 100% quando tutti i passaggi sono completati. Questo è l'unico indicatore affidabile di successo completo. Altri indicatori di avanzamento mostrano lo spostamento di byte, oggetti e metadati. Questi potrebbero raggiungere il 100% prima del metadata.commonMetadata.progressPercent. Dopo lo spostamento di byte, oggetti e metadati, il trasferimento del bucket completa i passaggi finali e successivamente metadata.commonMetadata.progressPercent viene aggiornato a 100%.

Se riscontri problemi durante l'interazione con altre funzionalità di Cloud Storage, consulta Limitazioni.

Avviare il passaggio di sincronizzazione finale

Per i trasferimenti che richiedono un tempo di inattività in scrittura, devi avviare la sincronizzazione finale. Il passaggio di sincronizzazione finale prevede un periodo in cui non puoi eseguire operazioni di scrittura sul bucket. Ti consigliamo di pianificare il passaggio di sincronizzazione finale in un momento che riduca al minimo le interruzioni delle tue applicazioni.

Console

Per avviare il passaggio di sincronizzazione finale, completa i seguenti passaggi:

Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.

Vai a Bucket
Nell'elenco dei bucket, fai clic sul nome del bucket che stai spostando.
Nella pagina Dettagli bucket, fai clic sulla scheda Operazioni.
Nell'elenco delle operazioni del bucket, fai clic sull'operazione di riposizionamento per visualizzare la pagina dei dettagli dell'operazione. Nella pagina dei dettagli dell'operazione, quando la copia dei dati è completa almeno al 99%, viene visualizzata una barra dei messaggi che indica che è il momento ottimale per avviare la sincronizzazione finale.
(Facoltativo) Per impostare il tempo di inattività massimo consentito per la scrittura, fai clic su Imposta il tempo di inattività massimo consentito (TTL) e specifica la durata massima del tempo di inattività.
Fai clic su Avvia sincronizzazione finale.
Nella finestra di dialogo di conferma visualizzata, fai clic su Avvia per iniziare la sincronizzazione finale.

La pagina dei dettagli dell'operazione mostra il riepilogo del trasferimento, le metriche chiave e un riepilogo degli errori.

Riga di comando

Prima di procedere, verifica che il bucket sia completamente preparato controllando il valore di finalizationState nell'output del passaggio Avvia lo spostamento del bucket.

Quando il valore finalizationState è READY, esegui il comando gcloud storage buckets relocate per avviare la sincronizzazione finale:

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

Dove:

BUCKET_NAME è il nome del bucket che vuoi trasferire.
OPERATION_ID è l'ID dell'operazione a lunga esecuzione di trasferimento del bucket, che viene restituito nella risposta dei metodi che chiami. Ad esempio, la seguente risposta viene restituita dalla chiamata di gcloud storage operations list e l'ID operazione a lunga esecuzione è AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74.

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

Imposta il flag ttl per avere un maggiore controllo sul processo di trasferimento. Ad esempio:

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

Dove:

TTL_DURATION è la durata (TTL) della fase di inattività della scrittura durante un processo di trasferimento. È espressa come stringa, ad esempio 12h per 12 ore. Il TTL_DURATION determina la durata massima consentita per la fase di inattività in scrittura. Se il tempo di inattività di scrittura supera questo limite, il processo di trasferimento torna automaticamente al passaggio di trasferimento del bucket e le operazioni di scrittura nel bucket vengono riattivate. Il valore deve essere compreso tra 6h (6 ore) e 48h (48 ore). Se non specificato, il valore predefinito è 12h (12 ore).

API JSON

Prima di procedere, verifica che il bucket sia completamente preparato controllando il valore di finalizationState nell'output del passaggio di rilocalizzazione del bucket. Per procedere, il valore di finalizationState deve essere READY.

Se avvii il passaggio di sincronizzazione finale in anticipo, il comando restituisce un messaggio di errore The relocate bucket operation is not ready to advance to finalization running state, ma il processo di trasferimento continua.

Ti consigliamo di attendere che il valore di progressPercent sia 99 prima di avviare il passaggio di sincronizzazione finale.

Avere gcloud CLI installato e inizializzato , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Crea un file JSON contenente le impostazioni per il trasferimento del bucket. Consulta la documentazione Buckets: advanceRelocateBucket per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni comuni da includere:
```
{
"expireTime": "EXPIRE_TIME",
"ttl": "TTL_DURATION"
}
```
Dove:
- EXPIRE_TIME è l'orario di scadenza del tempo di inattività in scrittura.
- TTL_DURATION è la durata (TTL) per la fase di inattività di scrittura durante un processo di trasferimento. È espressa come stringa, ad esempio 12h per 12 ore. Il TTL_DURATION determina la durata massima consentita per la fase di inattività in scrittura. Se il tempo di inattività di scrittura supera questo limite, il processo di trasferimento torna automaticamente al passaggio di trasferimento del bucket e le operazioni di scrittura nel bucket vengono riattivate. Il valore deve essere compreso tra 6h (6 ore) e 48h (48 ore). Se non specificato, il valore predefinito è 12h (12 ore).
Utilizza cURL per chiamare l'API 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"
```
Dove:
- JSON_FILE_NAME è il nome del file JSON che hai creato.
- BUCKET_NAME è il nome del bucket che vuoi trasferire.
- OPERATION_ID è l'ID dell'operazione a lunga esecuzione che ha avviato il riposizionamento del bucket. Per ottenere l'elenco degli ID delle operazione a lunga esecuzione per un bucket, consulta Operazioni: elenco.

Una volta spostato correttamente un bucket, non puoi avviare un altro spostamento per lo stesso bucket per un periodo di 14 giorni.

Convalidare la procedura di spostamento del bucket

Dopo aver avviato un trasferimento, verifica che sia stato completato correttamente. Questa sezione fornisce indicazioni su come confermare il trasferimento dei dati.

Convalida la riuscita della procedura di trasferimento utilizzando i seguenti metodi:

Esegui il polling delle operazioni a lunga esecuzione: il trasferimento del bucket è un'operazione a lunga esecuzione. Puoi eseguire il polling dell'operazione a lunga esecuzione utilizzando operation id per monitorare l'avanzamento dell'operazione e confermare il suo completamento corretto verificando lo stato success. Ciò comporta l'esecuzione periodica di query sullo stato dell'operazione finché non raggiunge uno stato terminale. Per informazioni sul monitoraggio delle operazioni a lunga esecuzione, consulta Utilizzare le operazioni a lunga esecuzione in Cloud Storage.
Analizza le voci di Cloud Audit Logs: Cloud Audit Logs fornisce un record dettagliato di eventi e operazioni nel tuo ambiente Google Cloud . Puoi analizzare le voci di Cloud Audit Logs associate al trasferimento per verificarne la riuscita. Analizza i log per rilevare eventuali errori, avvisi o comportamenti imprevisti che potrebbero indicare problemi durante il trasferimento. Per informazioni sulla visualizzazione dei log di Cloud Audit Logs, consulta Visualizzazione degli audit log.

Le seguenti voci di log ti aiutano a determinare se lo spostamento è riuscito o meno:
- Rilocazione riuscita: Relocate bucket succeeded. All existing objects are now in the new placement configuration.
- Spostamento non riuscito: Relocate bucket has failed. Bucket location remains unchanged.
Utilizzando le notifiche Pub/Sub, puoi anche configurare avvisi che ti informano quando l'evento specifico di esito positivo o negativo viene visualizzato nei log. Per informazioni sulla configurazione delle notifiche Pub/Sub, consulta Configurare le notifiche Pub/Sub per Cloud Storage.

Completare le attività post-spostamento del bucket

Dopo aver trasferito correttamente il bucket, completa i seguenti passaggi:

(Facoltativo) Ripristina i controlli dell'accesso basati su tag sul bucket.
Le configurazioni esistenti del report sull'inventario non vengono mantenute durante la procedura di trasferimento e dovrai ricrearle manualmente. Per informazioni sulla creazione di una configurazione di report dell'inventario, consulta Creare una configurazione di report dell'inventario.
Aggiorna le configurazioni dell'infrastruttura come codice, ad esempio Terraform e il connettore di configurazione Google Kubernetes Engine, per specificare la nuova posizione del bucket.
Gli endpoint regionali sono associati a località specifiche e dovrai modificare il codice dell'applicazione per riflettere il nuovo endpoint.

Come gestire le operazioni di spostamento del bucket non riuscite

Prima di gestire le operazioni di ricollocamento dei bucket non riuscite, considera i seguenti fattori:

Lo spostamento non riuscito di un bucket potrebbe lasciare risorse obsolete, come file temporanei o copie di dati incomplete, nella destinazione. Devi attendere da 7 a 14 giorni prima di avviare un altro spostamento del bucket nella stessa destinazione. Puoi avviare immediatamente il trasferimento di un bucket in una destinazione diversa.
Se la posizione di destinazione non è quella ottimale per i tuoi dati, potresti voler annullare il trasferimento. Tuttavia, non puoi avviare un trasferimento immediatamente. È necessario un periodo di attesa di massimo 14 giorni prima di poter avviare nuovamente la procedura di trasferimento per mantenere la stabilità ed evitare conflitti di dati.

Passaggi successivi

Scopri di più sullo spostamento dei bucket.

Sposta bucket Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Ottenere i ruoli richiesti

Autorizzazioni obbligatorie

Sposta bucket

(Facoltativo) Testa lo spostamento del bucket con una dry run

Console

Riga di comando

API JSON

Avvia lo spostamento del bucket

Console

Riga di comando

API JSON

Monitorare la procedura di trasferimento

Console

Riga di comando

API JSON

Avviare il passaggio di sincronizzazione finale

Console

Riga di comando

API JSON

Convalidare la procedura di spostamento del bucket

Completare le attività post-spostamento del bucket

Come gestire le operazioni di spostamento del bucket non riuscite

Passaggi successivi

Sposta bucket