REST Resource: projects.locations.jobs

Ressource: Job

Die Beschreibung des Jobs für Speicher-Batchvorgänge

JSON-Darstellung 
{
  "name": string,
  "description": string,
  "loggingConfig": {
    object (LoggingConfig)
  },
  "createTime": string,
  "scheduleTime": string,
  "completeTime": string,
  "counters": {
    object (Counters)
  },
  "errorSummaries": [
    {
      object (ErrorSummary)
    }
  ],
  "state": enum (State),

  // Union field source can be only one of the following:
  "bucketList": {
    object (BucketList)
  }
  // End of list of possible types for union field source.

  // Union field transformation can be only one of the following:
  "putObjectHold": {
    object (PutObjectHold)
  },
  "deleteObject": {
    object (DeleteObject)
  },
  "putMetadata": {
    object (PutMetadata)
  },
  "rewriteObject": {
    object (RewriteObject)
  }
  // End of list of possible types for union field transformation.
}
Felder
name

string

Kennung. Der Ressourcenname des Jobs.

Format: projects/{project}/locations/global/jobs/{jobId}.

Beispiel: projects/123456/locations/global/jobs/job01.

jobId ist in einem bestimmten Projekt für einen bestimmten Standort eindeutig. Wenn jobId nicht angegeben ist, wird eine vom Server generierte Kennung zugewiesen.
description

string

Optional. Eine vom Nutzer angegebene Beschreibung des Jobs.

Maximale Länge: 1.024 Byte bei Unicode-Codierung.
loggingConfig

object (LoggingConfig)

Optional. Logging-Konfiguration.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Job erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
scheduleTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Job geplant wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
completeTime

string (Timestamp format)

Nur Ausgabe. Die Zeit, zu der der Job abgeschlossen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
counters

object (Counters)

Nur Ausgabe. Informationen zum Fortschritt des Jobs.
errorSummaries[]

object (ErrorSummary)

Nur Ausgabe. Fasst Fehler zusammen, die mit Beispiel-Fehlerlogeinträgen aufgetreten sind.
state

enum (State)

Nur Ausgabe. Status des Jobs.
Union-Feld source. Gibt die zu transformierenden Objekte an. Für source ist nur einer der folgenden Werte zulässig:
bucketList

object (BucketList)

Gibt eine Liste von Buckets und ihren Objekten an, die transformiert werden sollen.
Union-Feld transformation. Vorgang, der für die Objekte ausgeführt werden soll. Für transformation ist nur einer der folgenden Werte zulässig:
putObjectHold

object (PutObjectHold)

Ändert den Hold-Status des Objekts.
deleteObject

object (DeleteObject)

Objekte löschen.
putMetadata

object (PutMetadata)

Aktualisiert Objektmetadaten. Ermöglicht das Aktualisieren von Metadaten mit festen Schlüsseln und benutzerdefinierten Metadaten. Beispiel: Cache-Control, Content-Disposition, Content-Encoding, Content-Language, Content-Type, Custom-Time und object retention.
rewriteObject

object (RewriteObject)

Schreibt das Objekt neu und aktualisiert Metadaten wie den KMS-Schlüssel.

BucketList

Beschreibt die Liste der Buckets und ihrer Objekte, die transformiert werden sollen.

JSON-Darstellung 
{
  "buckets": [
    {
      object (Bucket)
    }
  ]
}
Felder
buckets[]

object (Bucket)

Erforderlich. Liste der Buckets und ihrer zu transformierenden Objekte. Sie können nur einen Bucket pro Job angeben. Wenn mehrere Buckets angegeben werden, tritt ein Fehler auf.

Bucket

Beschreibt die Konfiguration eines einzelnen Buckets und seiner zu transformierenden Objekte.

JSON-Darstellung 
{
  "bucket": string,

  // Union field object_configuration can be only one of the following:
  "prefixList": {
    object (PrefixList)
  },
  "manifest": {
    object (Manifest)
  }
  // End of list of possible types for union field object_configuration.
}
Felder
bucket

string

Erforderlich. Bucket-Name für die zu transformierenden Objekte.
Union-Feld object_configuration. Gibt die zu transformierenden Objekte an. Für object_configuration ist nur einer der folgenden Werte zulässig:
prefixList

object (PrefixList)

Gibt Objekte an, die einem Präfixsatz entsprechen.
manifest

object (Manifest)

Gibt Objekte in einer Manifestdatei an.

PrefixList

Beschreibt die Präfixe der zu transformierenden Objekte.

JSON-Darstellung 
{
  "includedObjectPrefixes": [
    string
  ]
}
Felder
includedObjectPrefixes[]

string

Optional. Geben Sie mindestens ein Objektpräfix an. Beispiel:

  • Wenn Sie ein einzelnes Objekt abgleichen möchten, verwenden Sie ein einzelnes Präfix, prefix1.

  • Wenn Sie mehrere Objekte abgleichen möchten, verwenden Sie kommagetrennte Präfixe, prefix1,prefix2.

  • Wenn Sie alle Objekte abgleichen möchten, verwenden Sie ein leeres Präfix, ''.

Manifest

Beschreibt die Liste der zu transformierenden Objekte.

JSON-Darstellung 
{
  "manifestLocation": string
}
Felder
manifestLocation

string

Erforderlich. Geben Sie den Speicherort der Manifestdatei an, z. B. gs://bucket_name/path/object_name.csv. Das Manifest ist eine CSV-Datei, die in Cloud Storage hochgeladen wird und ein Objekt oder eine Liste von Objekten enthält, die Sie verarbeiten möchten. Jede Zeile im Manifest muss den bucket und name des Objekts enthalten. Optional können Sie die generation des Objekts angeben. Wenn Sie die generation nicht angeben, wird die aktuelle Version des Objekts verwendet.

Die Datei muss eine Kopfzeile im folgenden Format enthalten: bucket,name,generation. Die Spalte generation ist optional. Beispiel:

bucket,name,generation
bucket_1,object_1,generation_1
bucket_1,object_2,generation_2
bucket_1,object_3,generation_3

Hinweis: In der Manifestdatei dürfen nur Objekte im Bucket angegeben werden, der für den Job bereitgestellt wurde. Zeilen, die auf Objekte in anderen Buckets verweisen, werden ignoriert.

PutObjectHold

Beschreibt Optionen zum Aktualisieren von Objekt-Holds.

JSON-Darstellung 
{
  "temporaryHold": enum (HoldStatus),
  "eventBasedHold": enum (HoldStatus)
}
Felder
temporaryHold

enum (HoldStatus)

Erforderlich. Aktualisiert den temporären Hold-Status des Objekts. Wenn ein temporärer Hold für ein Objekt festgelegt ist, kann das Objekt nicht gelöscht oder ersetzt werden.
eventBasedHold

enum (HoldStatus)

Erforderlich. Aktualisiert den Status von ereignisbasierten Holds für Objekte. Wenn ein ereignisbasierter Hold für ein Objekt festgelegt ist, kann das Objekt nicht gelöscht oder ersetzt werden. Setzt die Zeit des Objekts im Bucket in Bezug auf die Aufbewahrungsdauer zurück.

HoldStatus

Beschreibt den Status des Holds.

Enums
HOLD_STATUS_UNSPECIFIED Standardwert. Der Hold-Status des Objekts wird nicht geändert.
SET Platziert den Hold.
UNSET Hebt den Hold auf.

DeleteObject

Beschreibt Optionen zum Löschen eines Objekts.

JSON-Darstellung 
{
  "permanentObjectDeletionEnabled": boolean
}
Felder
permanentObjectDeletionEnabled

boolean

Erforderlich. Steuert das Löschverhalten, wenn die Versionsverwaltung für den Bucket des Objekts aktiviert ist. Bei „true“ werden sowohl Live- als auch nicht aktuelle Objekte endgültig gelöscht. Andernfalls werden Live-Objekte in Buckets mit aktivierter Versionsverwaltung nicht aktuell und Objekte, die bereits nicht aktuell waren, werden übersprungen. Diese Einstellung hat keine Auswirkungen auf die Funktion zum vorläufigen Löschen. Alle von diesem Dienst gelöschten Objekte können während der Aufbewahrungsdauer für das vorläufige Löschen wiederhergestellt werden, sofern diese Funktion aktiviert ist. Wenn diese Option aktiviert ist und im Manifest keine Generation für ein Objekt angegeben ist, wird ein GetObjectMetadata-Aufruf ausgeführt, um die Generation des Liveobjekts zu ermitteln.

PutMetadata

Beschreibt Optionen zum Aktualisieren von Objektmetadaten.

JSON-Darstellung 
{
  "customMetadata": {
    string: string,
    ...
  },
  "contentDisposition": string,
  "contentEncoding": string,
  "contentLanguage": string,
  "contentType": string,
  "cacheControl": string,
  "customTime": string
  "objectRetention": {
    object (ObjectRetention)
  }
}
Felder
customMetadata

map (key: string, value: string)

Optional. Aktualisiert die benutzerdefinierten Metadaten des Objekts. Mit diesem Vorgang werden einzelne benutzerdefinierte Metadaten-Schlüssel/Wert-Paare hinzugefügt oder festgelegt. Bei Schlüsseln, die mit leeren Werten angegeben werden, werden die Werte gelöscht. Vorhandene benutzerdefinierte Metadatenschlüssel, die nicht in der Anfrage enthalten sind, bleiben unverändert. Weitere Informationen finden Sie unter Custom-Metadata.

Ein Objekt, das eine Liste von "key": "value"-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
contentDisposition

string

Optional. Aktualisiert die festen Content-Disposition-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Content-Disposition.
contentEncoding

string

Optional. Aktualisiert die festen Content-Encoding-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Content-Encoding.
contentLanguage

string

Optional. Aktualisiert die festen Metadaten für die Inhaltssprache der Objekte. Für Metadatenwerte müssen ISO 639-1-Sprachcodes verwendet werden. Metadatenwerte dürfen maximal 100 Zeichen lang sein. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Content-Language.
contentType

string

Optional. Aktualisiert die festen Content-Type-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Content-Type.
cacheControl

string

Optional. Aktualisiert die festen Cache-Control-Metadaten von Objekten. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Außerdem kann sich der Wert für Custom-Time nicht mehr verkürzen. Weitere Informationen finden Sie unter Cache-Control.
customTime

string

Optional. Aktualisiert die festen Metadaten für die benutzerdefinierte Zeit des Objekts. Nicht festgelegte Werte in der Anfrage werden ignoriert. Wenn Sie die Metadaten löschen möchten, legen Sie einen leeren Wert fest. Weitere Informationen finden Sie unter Custom-Time.
objectRetention

object (ObjectRetention)

Optional. Aktualsiert die Aufbewahrungskonfiguration eines Objekts. Nicht festgelegte Werte werden ignoriert. Damit die Aufbewahrung eines Objekts gelöscht wird, muss sich der retentionMode im Status UNLOCKED befinden und retainUntilTime muss auf einen leeren String festgelegt sein. Bei einem Objekt mit dem Aufbewahrungsmodus LOCKED kann die Aufbewahrung nicht aufgehoben und die retainUntilTime nicht verkürzt werden. Weitere Informationen finden Sie unter retainUntilTime.

ObjectRetention

Beschreibt die Konfiguration für die Objektaufbewahrung.

JSON-Darstellung 
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
Felder
retainUntilTime

string

Erforderlich. Das Ablaufdatum der Aufbewahrung des Objekts, während dessen das Objekt vor dem Löschen oder Überschreiben geschützt ist. Die Zeit muss im RFC 3339-Format angegeben werden, z. B. YYYY-MM-DD'T'HH:MM:SS.SS'Z'. Um die Aufbewahrung eines Objekts zu löschen, muss retentionMode den Wert UNLOCKED haben und retainUntilTime muss auf einen leeren String festgelegt werden.
retentionMode

enum (RetentionMode)

Erforderlich. Der Aufbewahrungsmodus.

RetentionMode

Der Aufbewahrungsmodus.

Enums
RETENTION_MODE_UNSPECIFIED Der Aufbewahrungsmodus ist nicht angegeben.
LOCKED Wenn der Aufbewahrungsmodus LOCKED ist, kann retainUntilTime nicht entfernt oder verkürzt werden.
UNLOCKED Wenn der Aufbewahrungsmodus UNLOCKED ist, kann retainUntilTime entfernt oder geändert werden.

RewriteObject

Beschreibt Optionen zum Umschreiben von Objekten.

JSON-Darstellung 
{
  "kmsKey": string
}
Felder
kmsKey

string

Erforderlich. Ressourcenname des Cloud KMS-Schlüssels, der zum Verschlüsseln des Objekts verwendet wird. Der Cloud KMS-Schlüssel muss sich am selben Ort wie das Objekt befinden. Weitere Informationen finden Sie unter Objekte mit einem Cloud KMS-Schlüssel verschlüsseln.

Format: projects/{project}/locations/{locationid}/keyRings/{keyring}/cryptoKeys/{key}

Beispiel: projects/123456/locations/us-central1/keyRings/my-keyring/cryptoKeys/my-key. Das Objekt wird neu geschrieben und mit dem angegebenen KMS-Schlüssel festgelegt.

LoggingConfig

Gibt das Cloud Logging-Verhalten an.

JSON-Darstellung 
{
  "logActions": [
    enum (LoggableAction)
  ],
  "logActionStates": [
    enum (LoggableActionState)
  ]
}
Felder
logActions[]

enum (LoggableAction)

Erforderlich. Gibt die Aktionen an, die protokolliert werden sollen.
logActionStates[]

enum (LoggableActionState)

Erforderlich. Status, in denen Aktionen protokolliert werden. Wenn das Feld leer ist, werden keine Logs generiert.

LoggableAction

Protokollierbare Aktionstypen.

Enums
LOGGABLE_ACTION_UNSPECIFIED Ungültiger Wert, um einen Standardwert zu vermeiden.
TRANSFORM Die entsprechende Transformationsaktion in diesem Job.

LoggableActionState

Filter für protokollierbare Aktionsstatus.

Enums
LOGGABLE_ACTION_STATE_UNSPECIFIED Ungültiger Wert, um einen Standardwert zu vermeiden.
SUCCEEDED LoggableAction wurde erfolgreich abgeschlossen. SUCCEEDED-Aktionen werden als [INFO][google.logging.type.LogSeverity.INFO] protokolliert.
FAILED LoggableAction wurde mit einem Fehlerstatus beendet. FAILED-Aktionen werden als [ERROR][google.logging.type.LogSeverity.ERROR] protokolliert.

Zähler

Beschreibt Details zum Fortschritt des Jobs.

JSON-Darstellung 
{
  "totalObjectCount": string,
  "succeededObjectCount": string,
  "failedObjectCount": string
}
Felder
totalObjectCount

string (int64 format)

Nur Ausgabe. Anzahl der gelisteten Objekte.
succeededObjectCount

string (int64 format)

Nur Ausgabe. Anzahl der abgeschlossenen Objekte.
failedObjectCount

string (int64 format)

Nur Ausgabe. Anzahl der fehlgeschlagenen Objekte.

ErrorSummary

Eine Zusammenfassung der Fehler nach Fehlercode sowie eine Anzahl und Beispiel-Fehlerlogeinträge.

JSON-Darstellung 
{
  "errorCode": enum (Code),
  "errorCount": string,
  "errorLogEntries": [
    {
      object (ErrorLogEntry)
    }
  ]
}
Felder
errorCode

enum (Code)

Erforderlich. Der kanonische Fehlercode.
errorCount

string (int64 format)

Erforderlich. Anzahl der Fehler, die pro errorCode aufgetreten sind.
errorLogEntries[]

object (ErrorLogEntry)

Erforderlich. Beispiel für Fehlerlogs.

Code

Definiert Fehlercodes, die für die Verarbeitung von gRPC API-Antworten verwendet werden.

Wenn mehrere Fehlercodes zutreffen, geben Sie den spezifischsten Fehlercode zurück. Beispiel: OUT_OF_RANGE sollte gegenüber FAILED_PRECONDITION bevorzugt werden, wenn beide Codes zutreffen. Entsprechend ist NOT_FOUND oder ALREADY_EXISTS gegenüber FAILED_PRECONDITION vorzuziehen.

Enums
OK

Wird zurückgegeben, wenn der Vorgang erfolgreich abgeschlossen wurde.

HTTP Mapping: 200 OK
CANCELLED

Der Vorgang wurde abgebrochen, üblicherweise vom Aufrufer.

HTTP Mapping: 499 Client Closed Request
UNKNOWN

Unbekannter Fehler. Dieser Fehler wird z. B. angezeigt, wenn ein von einem anderen Adressbereich erhaltener Status-Wert zu einem Fehlerbereich gehört, der in diesem Adressbereich nicht bekannt ist. Auch Fehler, die von APIs ausgelöst werden, die nicht genügend Fehlerinformationen liefern, können in diesen Fehler umgewandelt werden.

HTTP Mapping: 500 Internal Server Error
INVALID_ARGUMENT

Der Client hat ein ungültiges Argument angegeben. Dieser Wert ist nicht identisch mit FAILED_PRECONDITION. INVALID_ARGUMENT gibt Argumente an, die ungeachtet des Systemstatus problematisch sind (z. B. ein ungültiger Dateiname).

HTTP Mapping: 400 Bad Request
DEADLINE_EXCEEDED

Die Frist ist abgelaufen, bevor der Vorgang abgeschlossen werden konnte. Bei Vorgängen, die den Systemstatus verändern, kann dieser Fehler angezeigt werden, auch wenn der Vorgang erfolgreich abgeschlossen wurde. Zum Beispiel könnte eine erfolgreiche Antwort von einem Server so lange verzögert worden sein, dass die Frist abgelaufen ist.

HTTP Mapping: 504 Gateway Timeout
NOT_FOUND

Eine angeforderte Entität (z. B. Datei oder Verzeichnis) wurde nicht gefunden.

Hinweis für Serverentwickler: Wenn eine Anfrage, z. B. eine schrittweise Einführung von Funktionen oder eine undokumentierte Zulassungsliste, für eine gesamte Nutzerklasse abgelehnt wird, kann NOT_FOUND verwendet werden. Wenn eine Anfrage, z. B. nutzerbasierte Zugriffssteuerung, für einige Nutzer innerhalb einer Nutzerklasse abgelehnt wird, muss PERMISSION_DENIED verwendet werden.

HTTP Mapping: 404 Not Found
ALREADY_EXISTS

Die Entität, die ein Client erstellen wollte (z. B. eine Datei oder ein Verzeichnis), ist bereits vorhanden.

HTTP Mapping: 409 Conflict
PERMISSION_DENIED

Der Aufrufer hat keine Berechtigung zur Ausführung des angegebenen Vorgangs. PERMISSION_DENIED darf nicht für Ablehnungen verwendet werden, die dadurch verursacht werden, dass eine Ressource erschöpft ist (verwenden Sie stattdessen RESOURCE_EXHAUSTED für diese Fehler). PERMISSION_DENIED darf nicht verwendet werden, wenn der Aufrufer nicht ermittelt werden kann (verwenden Sie stattdessen UNAUTHENTICATED für diese Fehler). Dieser Fehlercode impliziert nicht, dass die Anfrage gültig ist oder die angefragte Entität existiert oder andere Vorbedingungen erfüllt.

HTTP Mapping: 403 Forbidden
UNAUTHENTICATED

Die Anfrage enthält keine gültigen Authentifizierungsanmeldedaten für diesen Vorgang.

HTTP Mapping: 401 Unauthorized
RESOURCE_EXHAUSTED

Eine Ressource, z. B. ein nutzerbezogenes Kontingent, ist erschöpft oder der Speicherplatz für das gesamte Dateisystem ist ausgegangen.

HTTP Mapping: 429 Too Many Requests
FAILED_PRECONDITION

Der Vorgang wurde abgelehnt, weil der Systemzustand nicht für die Ausführung des Vorgangs geeignet ist. Beispielsweise ist das zu löschende Verzeichnis nicht leer, ein rmdir-Vorgang wird auf eine Ressource angewendet, die kein Verzeichnis ist, usw.

Dienstimplementierungen können anhand der folgenden Richtlinien zwischen FAILED_PRECONDITION, ABORTED und UNAVAILABLE entscheiden:

  • Verwenden Sie UNAVAILABLE, wenn der Client nur den fehlgeschlagenen Aufruf wiederholen kann.
  • Verwenden Sie ABORTED, wenn der Client den Vorgang auf einer höheren Ebene wiederholen soll, z. B. wenn ein vom Client angegebener Test- und Set-Wert fehlschlägt. Dies bedeutet, dass der Client eine Read-Modify-Write-Sequenz neu starten sollte.
  • Soll der Client den Versuch nicht wiederholen, bis der Systemstatus ausdrücklich festgelegt wurde, verwenden Sie FAILED_PRECONDITION. Wenn beispielsweise ein „rmdir“ fehlschlägt, weil das Verzeichnis nicht leer ist, sollte FAILED_PRECONDITION zurückgegeben werden, da der Client die Wiederholung erst dann versuchen sollte, wenn die Dateien aus dem Verzeichnis gelöscht wurden.

HTTP Mapping: 400 Bad Request
ABORTED

Der Vorgang wurde abgebrochen, in der Regel aufgrund eines Parallelitätsproblems wie einer fehlgeschlagenen Sequencer-Überprüfung oder einer abgebrochenen Transaktion.

Siehe obige Richtlinien zum Abwägen zwischen FAILED_PRECONDITION, ABORTED und UNAVAILABLE.

HTTP Mapping: 409 Conflict
OUT_OF_RANGE

Beim Vorgang wurde versucht, den gültigen Bereich zu überschreiten. Beispiel: Such- oder Lesevorgang über das Dateiende hinaus.

Im Gegensatz zu INVALID_ARGUMENT zeigt dieser Fehler ein Problem an, das behoben werden kann, wenn sich der Systemstatus ändert. Zum Beispiel erzeugt ein 32-Bit-Dateisystem INVALID_ARGUMENT, wenn es in einem Bereich lesen soll, der nicht innerhalb des Bereichs [0,2^32-1] liegt. Dagegen generiert es OUT_OF_RANGE, wenn für einen Bereich gelesen werden soll, der die aktuelle Dateigröße übersteigt.

Es gibt einige Überschneidungen zwischen FAILED_PRECONDITION und OUT_OF_RANGE. Wir empfehlen die Verwendung von OUT_OF_RANGE (der spezifischere Fehler), wenn dies zutrifft, damit die Aufrufer, die über einen Bereich iterieren, einfach nach einem OUT_OF_RANGE-Fehler suchen können, wenn sie fertig sind.

HTTP Mapping: 400 Bad Request
UNIMPLEMENTED

Dieser Vorgang ist nicht implementiert oder wird bei diesem Dienst nicht unterstützt bzw. ist bei diesem Dienst nicht aktiviert.

HTTP Mapping: 501 Not Implemented
INTERNAL

Interne Fehler. Das bedeutet, dass einige Invarianten, die vom zugrunde liegenden System erwartet werden, nicht erfüllt wurden. Dieser Fehlercode ist für schwerwiegende Fehler reserviert.

HTTP Mapping: 500 Internal Server Error
UNAVAILABLE

Der Dienst ist derzeit nicht verfügbar. Dies ist höchstwahrscheinlich ein vorübergehender Zustand, der durch Wiederholen mit einem Backoff korrigiert werden kann. Es ist nicht immer sicher, nicht idempotente Vorgänge zu wiederholen.

Siehe obige Richtlinien zum Abwägen zwischen FAILED_PRECONDITION, ABORTED und UNAVAILABLE.

HTTP Mapping: 503 Service Unavailable
DATA_LOSS

Dauerhafter Datenverlust oder Datenkorruption.

HTTP Mapping: 500 Internal Server Error

ErrorLogEntry

Ein Eintrag, der einen aufgetretenen Fehler beschreibt.

JSON-Darstellung 
{
  "objectUri": string,
  "errorDetails": [
    string
  ]
}
Felder
objectUri

string

Erforderlich. Nur Ausgabe. Objekt-URL. Beispiel: gs://my_bucket/object.txt
errorDetails[]

string

Optional. Nur Ausgabe. Pro Fehlercode werden maximal fünf Fehlerlogeinträge für jeden Job aufgezeichnet.

Status

Beschreibt den Status eines Jobs.

Enums
STATE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
RUNNING In Bearbeitung.
SUCCEEDED Erfolgreich abgeschlossen.
CANCELED Vom Nutzer abgebrochen.
FAILED Aufgrund eines nicht behebbaren Fehlers beendet.

Methoden

cancel

 Bricht einen Batchjob in einem angegebenen Projekt für einen angegebenen Standort ab.

create

 Erstellt einen Batchjob in einem bestimmten Projekt für einen bestimmten Standort.

delete

 Löscht einen Batchjob in einem bestimmten Projekt für einen bestimmten Standort.

get

 Ruft einen Batchjob in einem bestimmten Projekt für einen bestimmten Standort ab.

list

 Listet alle Batchjobs in einem bestimmten Projekt für einen bestimmten Standort auf.