Utilizza operazioni a lunga esecuzione in Cloud Storage

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 a gcloud 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 a gcloud 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.