Method: transferJobs.list

Listet Übertragungsjobs auf.

HTTP-Anfrage

GET https://storagetransfer.googleapis.com/v1/transferJobs

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
filter

string

Pflichtangabe. Eine Liste von Abfrageparametern, die als JSON-Text im folgenden Format angegeben ist:

{
  "projectId":"my_project_id",
  "jobNames":["jobid1","jobid2",...],
  "jobStatuses":["status1","status2",...],
  "dataBackend":"QUERY_REPLICATION_CONFIGS",
  "sourceBucket":"source-bucket-name",
  "sinkBucket":"sink-bucket-name",
}

Die JSON-Formatierung im Beispiel dient nur zur Anzeige. Geben Sie die Abfrageparameter ohne Leerzeichen oder Zeilenumbrüche an.

  • Das Feld „projectId“ darf nicht leer sein.
  • Da jobNames und jobStatuses mehrere Werte unterstützen, müssen ihre Werte in Arrayschreibweise angegeben werden. jobNames und jobStatuses sind optional. Bei gültigen Werten wird die Groß- und Kleinschreibung nicht berücksichtigt:
  • Geben Sie "dataBackend":"QUERY_REPLICATION_CONFIGS" an, um eine Liste der Jobs für die Bucket-übergreifende Replikation abzurufen.
  • Begrenzen Sie die Ergebnisse mit sourceBucket auf Jobs aus einem bestimmten Bucket und/oder mit sinkBucket auf einen bestimmten Bucket.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource filter erforderlich:

  • storagetransfer.jobs.list
pageSize

integer

Die Größe der Listenseite. Der maximal zulässige Wert ist 256.
pageToken

string

Das Token der Listenseite.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort von transferJobs.list

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "transferJobs": [
    {
      object (TransferJob)
    }
  ],
  "nextPageToken": string
}
Felder
transferJobs[]

object (TransferJob)

Eine Liste der Übertragungsjobs.
nextPageToken

string

Das Token für die nächste Listenseite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.