Utilizza operazioni a lunga esecuzione in Cloud Storage

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