REST-Ressource: projects.locations.transferConfigs.runs

Ressource: TransferRun

Stellt eine Datenübertragungsausführung dar.

JSON-Darstellung

{
  "name": string,
  "scheduleTime": string,
  "runTime": string,
  "errorStatus": {
    object (Status)
  },
  "startTime": string,
  "endTime": string,
  "updateTime": string,
  "params": {
    object
  },
  "dataSourceId": string,
  "state": enum (TransferState),
  "userId": string,
  "schedule": string,
  "notificationPubsubTopic": string,
  "emailPreferences": {
    object (EmailPreferences)
  },
  "destinationDatasetId": string
}
Felder
name

string

Der Ressourcenname der Übertragungsausführung; Namen von Übertragungsausführungen haben das Format projects/{projectId}/locations/{location}/transferConfigs/{configId}/runs/{run_id}. Der Name wird beim Erstellen einer Übertragungsausführung ignoriert.

scheduleTime

string (Timestamp format)

Die Mindestzeit, nach der eine Übertragungsausführung gestartet werden kann.

runTime

string (Timestamp format)

Damit werden für die Ausführung von Batchübertragungen das Datum und die Uhrzeit der Daten angegeben, die aufgenommen werden sollen.

errorStatus

object (Status)

Der Status der Übertragungsausführung

startTime

string (Timestamp format)

Nur Ausgabe. enthält den Zeitpunkt, an dem die Übertragungsausführung gestartet wurde. Der Parameter wird vom Server bei Eingabe-Requests ignoriert.

endTime

string (Timestamp format)

Nur Ausgabe. enthält den Zeitpunkt, an dem die Übertragungsausführung beendet wurde. Der Parameter wird vom Server bei Eingabe-Requests ignoriert.

updateTime

string (Timestamp format)

Nur Ausgabe. Der letzte Zeitpunkt, an dem der Status der Datenübertragungsausführung aktualisiert wurde.

params

object (Struct format)

Nur Ausgabe. enthält datenübertragungsspezifische Parameter.

dataSourceId

string

Nur Ausgabe. Die ID der Datenquelle.

state

enum (TransferState)

Der Status der Datenübertragungsausführung. Wird bei Eingabeanforderungen ignoriert.

userId

string (int64 format)

Veraltet. Enthält die eindeutige ID des Nutzers, in dessen Namen die Daten übertragen werden.

schedule

string

Nur Ausgabe. beschreibt den Zeitplan dieser Übertragungsausführung, wenn sie im Rahmen eines regulären Zeitplans erstellt wurde. Bei Batchübertragungsausführungen, die manuell geplant werden, ist dieses Feld leer. HINWEIS: Es kann vorkommen, dass der Zeitplan je nach aktueller Arbeitslast verzögert wird. scheduleTime wird deshalb nicht immer eingehalten.

notificationPubsubTopic

string

Nur Ausgabe. Pub/Sub-Thema, an das nach Ausführung dieser Übertragung eine Benachrichtigung gesendet wird.

emailPreferences

object (EmailPreferences)

Nur Ausgabe. E-Mail-Benachrichtigungen werden gemäß diesen Einstellungen an die E-Mail-Adresse des Inhabers der Übertragungskonfiguration gesendet, aus der diese Ausführung abgeleitet wurde.

destinationDatasetId

string

Nur Ausgabe. Enthält die ID des BigQuery-Ziel-Datasets.

Status

Mit dem Typ Status wird ein logisches Fehlermodell definiert, das für verschiedene Programmierumgebungen wie REST APIs und RPC APIs geeignet ist. Dieses Modell wird von gRPC verwendet. Jede Status-Meldung enthält die folgenden drei Datenelemente: Fehlercode, Fehlermeldung und Fehlerdetails.

Weitere Informationen zu diesem Fehlermodell und zur Arbeit damit finden Sie in der API-Designanleitung.

JSON-Darstellung

{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Felder
code

integer

Der Statuscode, der idealerweise ein ENUM-Wert von google.rpc.Code ist.

message

string

Eine an Entwickler gerichtete Fehlermeldung, die englischsprachig sein sollte. Jede Fehlermeldung an den Nutzer sollte lokalisiert und im Feld google.rpc.Status.details gesendet werden. Sie kann auch clientseitig lokalisiert werden.

details[]

object

Eine Auflistung aller Meldungen, die die Fehlerdetails enthalten. Es gibt einen gemeinsamen Satz von Nachrichtentypen, die APIs verwenden können.

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

Methoden

delete

Löscht die angegebene Übertragungsausführung.

get

Gibt Informationen zur jeweiligen Übertragungsausführung zurück.

list

Gibt Informationen zu laufenden und abgeschlossenen Jobs zurück.