In questa pagina viene descritto come utilizzare le operazioni a lunga esecuzione che vengono o avviato dall'utilizzo di chiamate al metodo in Cloud Storage. Per dettagli informazioni sulla semantica di un'operazione a lunga esecuzione, tra cui quali richieste possono essere eseguite sull'operazione a lunga esecuzione, consulta la documentazione specifica per le funzionalità.
Per informazioni generali su come gestire le operazioni a lunga esecuzione, consulta
Documentazione di gcloud storage operations
.
Visualizza i dettagli di un'operazione a lunga esecuzione
Per conoscere i dettagli o controllare lo stato di un'operazione a lunga esecuzione, utilizza
Comando gcloud storage operations describe
:
gcloud storage operations describe projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID
Sostituisci:
BUCKET_NAME
con il nome del bucket che contiene l'operazione a lunga esecuzione. Ad esempio,my-bucket
.OPERATION_ID
con l'ID del segmento di pubblico a lunga esecuzione che viene restituita nella risposta dei metodi chiamati. Per Ad esempio, la chiamata restituisce la seguente rispostagcloud storage restore
e l'ID dell'operazione a lunga esecuzione èBcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP
:Created: projects/_/buckets/my-bucket/operations/BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP
Elenca le operazioni a lunga esecuzione in un bucket
Per elencare le operazioni a lunga esecuzione in un bucket, utilizza la classe
Comando gcloud storage operations list
:
gcloud storage operations list gs://BUCKET_NAME
Sostituisci:
BUCKET_NAME
con il nome del bucket che contiene le operazioni a lunga esecuzione. Ad esempio,my-bucket
.
Annullare un'operazione a lunga esecuzione
Per annullare un'operazione a lunga esecuzione, utilizza
Comando gcloud storage operations cancel
:
gcloud storage operations cancel projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID
Sostituisci:
BUCKET_NAME
con il nome del bucket che contiene l'operazione a lunga esecuzione. Ad esempio,my-bucket
.OPERATION_ID
con l'ID del segmento di pubblico a lunga esecuzione che viene restituita nella risposta dei metodi chiamati. Per Ad esempio, la chiamata restituisce la seguente rispostagcloud storage restore
e l'ID dell'operazione a lunga esecuzione èBcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP
:Created: projects/_/buckets/my-bucket/operations/BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP
Gestione degli errori
Le operazioni a lunga esecuzione vengono avviate da API asincrone e richiedono pratiche di gestione degli errori diverse rispetto alle API sincrone. A differenza dell'audio sincrono API, la risposta alle chiamate API asincrone può indicare l'esito positivo anche se l'operazione a lunga esecuzione non va a buon fine. Invece di affidarti allo stato che viene restituito nelle intestazioni della risposta, occorre analizzare metadati delle operazione a lunga esecuzione nel corpo della risposta per determinare per vedere se una chiamata API è riuscita.
Ad esempio, se effettui una richiesta di ripristino collettivo di eliminazione temporanea, verrà restituita
codice di stato HTTP (200 OK
) anche se si verifica un errore durante il corso
dell'operazione. Per verificare se il ripristino collettivo è riuscito,
recupera lo stato dell'operazione a lunga esecuzione.
Tieni presente che le API per le operazione a lunga esecuzione (Get, List, Cancel) sincrono e restituisce gli errori normali.