Questa pagina descrive come utilizzare le operazioni a lunga esecuzione avviate dall'utilizzo delle chiamate ai metodi in Cloud Storage. Per informazioni dettagliate sulla semantica di un'operazione a lunga esecuzione, incluse le richieste che possono essere eseguite sull'operazione a lunga esecuzione, consulta la documentazione specifica delle funzionalità.
Per informazioni generali su come gestire le operazioni a lunga esecuzione, consulta la documentazione di gcloud storage operations
.
Visualizza i dettagli di un'operazione a lunga esecuzione
Per ottenere i dettagli o controllare lo stato di un'operazione a lunga esecuzione, utilizza il
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 dell'operazione a lunga esecuzione, che viene restituito nella risposta dei metodi chiamati. Ad esempio, la chiamata agcloud storage restore
restituisce la seguente risposta 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 il 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 il
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 dell'operazione a lunga esecuzione, che viene restituito nella risposta dei metodi chiamati. Ad esempio, la chiamata agcloud storage restore
restituisce la seguente risposta 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 delle API sincrone, la risposta alle chiamate API asincrone può indicare l'esito positivo anche se l'operazione a lunga esecuzione alla fine non va a buon fine. Anziché fare affidamento sul codice di stato restituito nelle intestazioni della risposta, devi analizzare i metadati operazione a lunga esecuzione nel corpo della risposta per determinare se una chiamata API è riuscita.
Ad esempio, se effettui una richiesta di ripristino collettivo di eliminazione temporanea, verrà restituito un codice di stato HTTP (200 OK
) riuscito anche se si verifica un errore nel 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) sono sincrone e restituiscono errori normali.