Auf dieser Seite wird beschrieben, wie Sie Vorgänge mit langer Ausführungszeit verwenden, die durch Methodenaufrufe in Cloud Storage initiiert werden. Ausführliche Informationen zur Semantik eines Vorgangs mit langer Ausführungszeit, einschließlich der Anfragen, die im Zusammenhang mit dem Vorgang mit langer Ausführungszeit ausgeführt werden können, finden Sie in der funktionsspezifischen Dokumentation.
Allgemeine Informationen zum Verwalten von Vorgängen mit langer Ausführungszeit finden Sie in der Dokumentation zu gcloud storage operations.
Details eines lang andauernden Vorgangs abrufen
Verwenden Sie den Befehl gcloud storage operations describe, um die Details abzurufen oder den Status eines Vorgangs mit langer Ausführungszeit zu prüfen:
gcloud storage operations describe projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID
Ersetzen Sie:
BUCKET_NAMEdurch den Namen des Buckets, der den Vorgang mit langer Ausführungszeit enthält. Beispiel:my-bucket.OPERATION_IDdurch die ID des lang andauernden Vorgangs, der in der Antwort der von Ihnen aufgerufenen Methoden zurückgegeben wird. Beispielsweise wird beim Aufrufen vongcloud storage restoredie folgende Antwort zurückgegeben und die ID des Vorgangs mit langer Ausführungszeit lautetBcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP:Created: projects/_/buckets/my-bucket/operations/BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP
Vorgänge mit langer Ausführungszeit in einem Bucket auflisten
Um die Vorgänge mit langer Ausführungszeit in einem Bucket aufzulisten, verwenden Sie den gcloud storage operations list-Befehl:
gcloud storage operations list gs://BUCKET_NAME
Ersetzen Sie:
BUCKET_NAMEdurch den Namen des Buckets, der die Vorgänge mit langer Ausführungszeit enthält. Beispiel:my-bucket.
Lange laufenden Vorgang abbrechen
Verwenden Sie den Befehl gcloud storage operations cancel, um einen Vorgang mit langer Ausführungszeit abzubrechen:
gcloud storage operations cancel projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID
Ersetzen Sie:
BUCKET_NAMEdurch den Namen des Buckets, der den Vorgang mit langer Ausführungszeit enthält. Beispiel:my-bucket.OPERATION_IDdurch die ID des lang andauernden Vorgangs, der in der Antwort der von Ihnen aufgerufenen Methoden zurückgegeben wird. Beispielsweise wird beim Aufrufen vongcloud storage restoredie folgende Antwort zurückgegeben und die ID des Vorgangs mit langer Ausführungszeit lautetBcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP:Created: projects/_/buckets/my-bucket/operations/BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP
Fehlerbehandlung
Vorgänge mit langer Ausführungszeit werden von asynchronen APIs initiiert und erfordern eine andere Fehlerbehandlung als synchrone APIs. Im Gegensatz zu synchronen APIs kann die Antwort auf asynchrone API-Aufrufe auch dann erfolgreich sein, wenn der Vorgang mit langer Ausführungszeit schließlich fehlschlägt. Anstatt sich auf den Statuscode zu verlassen, der in den Antwort-Headern zurückgegeben wird, sollten Sie die Metadaten des Vorgangs mit langer Ausführungszeit im Text der Antwort parsen, um festzustellen, ob ein API-Aufruf erfolgreich war.
Wenn Sie beispielsweise eine Bulk-Wiederherstellungsanfrage für vorläufiges Löschen stellen, wird ein erfolgreicher HTTP-Statuscode (200 OK) zurückgegeben, auch wenn während des Vorgangs ein Fehler auftritt. Um zu prüfen, ob der Bulk-Wiederherstellungsvorgang erfolgreich war, fragen Sie den Status des Vorgangs mit langer Ausführungszeit ab.
Beachten Sie, dass die APIs für Vorgänge mit langer Ausführungszeit (Get, List, Cancel) synchron sind und normale Fehler zurückgeben.