TransferOptions

Mit „TransferOptions“ werden die Aktionen definiert, die auf Objekte in einer Übertragung angewendet werden sollen.

JSON-Darstellung
{
  "overwriteObjectsAlreadyExistingInSink": boolean,
  "deleteObjectsUniqueInSink": boolean,
  "deleteObjectsFromSourceAfterTransfer": boolean,
  "overwriteWhen": enum (OverwriteWhen),
  "metadataOptions": {
    object (MetadataOptions)
  }
}
Felder
overwriteObjectsAlreadyExistingInSink

boolean

Gibt an, wann Objekte überschrieben werden, die bereits im Datenablauf vorhanden sind. Standardmäßig werden nur Objekte überschrieben, die sich von der Quelle unterscheiden. Wenn diese Option aktiviert ist, werden alle Objekte im Ziel, deren Name mit einem Objekt in der Quelle übereinstimmt, mit dem Quellobjekt überschrieben.

deleteObjectsUniqueInSink

boolean

Gibt an, ob Objekte, die nur im Datensink vorhanden sind, gelöscht werden sollen.

Hinweis:Diese Option und deleteObjectsFromSourceAfterTransfer schließen sich gegenseitig aus.

deleteObjectsFromSourceAfterTransfer

boolean

Gibt an, ob Objekte aus der Quelle gelöscht werden sollen, nachdem sie in den Zielspeicher übertragen wurden.

Hinweis:Diese Option und deleteObjectsUniqueInSink schließen sich gegenseitig aus.

overwriteWhen

enum (OverwriteWhen)

Gibt an, wann Objekte überschrieben werden, die bereits im Datenablauf vorhanden sind. Wenn nicht festgelegt, wird das Überschreibungsverhalten durch overwriteObjectsAlreadyExistingInSink bestimmt.

metadataOptions

object (MetadataOptions)

Stellt die ausgewählten Metadatenoptionen für einen Übertragungsjob dar.

OverwriteWhen

Gibt an, wann ein Objekt im Ziel überschrieben werden soll, wenn in der Quelle ein Objekt mit demselben Namen gefunden wird.

Enums
OVERWRITE_WHEN_UNSPECIFIED Das Überschreibungsverhalten ist nicht angegeben.
DIFFERENT Zielobjekte werden nur dann mit den Quellobjekten überschrieben, wenn die Objekte denselben Namen, aber unterschiedliche HTTP-ETags oder Prüfsummenwerte haben.
NEVER Zielobjekte werden nie überschrieben, wenn ein Quellobjekt denselben Namen hat. In diesem Fall wird das Quellobjekt nicht übertragen.
ALWAYS Das Zielobjekt wird immer mit dem Quellobjekt überschrieben, auch wenn die HTTP-ETags oder Prüfsummenwerte identisch sind.

MetadataOptions

Gibt die Metadatenoptionen für die Ausführung einer Übertragung an.

JSON-Darstellung
{
  "symlink": enum (Symlink),
  "mode": enum (Mode),
  "gid": enum (GID),
  "uid": enum (UID),
  "acl": enum (Acl),
  "storageClass": enum (StorageClass),
  "temporaryHold": enum (TemporaryHold),
  "kmsKey": enum (KmsKey),
  "timeCreated": enum (TimeCreated)
}
Felder
mode

enum (Mode)

Gibt an, wie das Attribut „mode“ der einzelnen Dateien bei der Übertragung behandelt werden soll. Standardmäßig wird der Modus nicht beibehalten. Nur für Übertragungen mit POSIX-Dateisystemen anwendbar, bei anderen Übertragungen wird die Option ignoriert.

gid

enum (GID)

Gibt an, wie das POSIX-Attribut „Gruppen-ID“ (GID) der einzelnen Dateien bei der Übertragung behandelt werden soll. Standardmäßig wird die GID nicht beibehalten. Nur für Übertragungen mit POSIX-Dateisystemen anwendbar, bei anderen Übertragungen wird die Option ignoriert.

uid

enum (UID)

Gibt an, wie das POSIX-Attribut „User ID“ (UID) jeder Datei bei der Übertragung behandelt werden soll. Standardmäßig wird die UID nicht beibehalten. Nur für Übertragungen mit POSIX-Dateisystemen anwendbar, bei anderen Übertragungen wird die Option ignoriert.

acl

enum (Acl)

Gibt an, wie die ACLs der einzelnen Objekte bei Übertragungen zwischen Google Cloud Storage-Buckets beibehalten werden sollen. Wenn keine Angabe erfolgt, entspricht das Standardverhalten ACL_DESTINATION_BUCKET_DEFAULT.

storageClass

enum (StorageClass)

Gibt die Speicherklasse an, die für Objekte festgelegt werden soll, die in Google Cloud Storage-Buckets übertragen werden. Wenn keine Angabe erfolgt, entspricht das Standardverhalten STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT.

temporaryHold

enum (TemporaryHold)

Gibt an, wie der Status der vorübergehenden Sperrung jedes Objekts bei Übertragungen zwischen Google Cloud Storage-Buckets beibehalten werden soll. Wenn keine Angabe erfolgt, entspricht das Standardverhalten TEMPORARY_HOLD_PRESERVE.

kmsKey

enum (KmsKey)

Gibt an, wie der vom Kunden verwaltete Cloud KMS-Verschlüsselungsschlüssel (CMEK) jedes Objekts für Übertragungen zwischen Google Cloud Storage-Buckets beibehalten wird. Wenn keine Angabe erfolgt, entspricht das Standardverhalten KMS_KEY_DESTINATION_BUCKET_DEFAULT.

timeCreated

enum (TimeCreated)

Gibt an, wie die timeCreated-Metadaten der einzelnen Objekte für Übertragungen beibehalten werden. Wenn keine Angabe erfolgt, entspricht das Standardverhalten TIME_CREATED_SKIP. Dieses Verhalten wird für Übertragungen in Cloud Storage-Buckets von Cloud Storage-, Amazon S3-, S3-kompatiblen Speichern und Azure-Quellen unterstützt.

Modus

Optionen für die Verarbeitung des Dateimodusattributs.

Enums
MODE_UNSPECIFIED Das Modusverhalten ist nicht angegeben.
MODE_SKIP Verwenden Sie während eines Übertragungsjobs nicht den Modus „Beibehalten“.
MODE_PRESERVE Beibehaltungsmodus während eines Übertragungsjobs

GID

Optionen für die Verarbeitung des GID-Attributs von Dateien.

Enums
GID_UNSPECIFIED Das Verhalten der GID ist nicht angegeben.
GID_SKIP Bei einem Übertragungsjob darf die GID nicht beibehalten werden.
GID_NUMBER GID während eines Übertragungsjobs beibehalten

UID

Optionen für die Verarbeitung des Datei-UID-Attributs.

Enums
UID_UNSPECIFIED Das Verhalten der UID ist nicht angegeben.
UID_SKIP Bei einem Übertragungsjob darf die UID nicht beibehalten werden.
UID_NUMBER UID während eines Übertragungsjobs beibehalten

Acl

Optionen für die Verwaltung von Cloud Storage-Objekt-ACLs.

Enums
ACL_UNSPECIFIED Das ACL-Verhalten ist nicht angegeben.
ACL_DESTINATION_BUCKET_DEFAULT Verwenden Sie gegebenenfalls die Standardobjekt-ACLs des Ziel-Buckets.
ACL_PRESERVE Die ursprünglichen ACLs des Objekts beibehalten. Dazu muss das Dienstkonto die Berechtigung storage.objects.getIamPolicy für das Quellobjekt haben. Der einheitliche Zugriff auf Bucket-Ebene darf weder für den Quell- noch für den Ziel-Bucket aktiviert sein.

StorageClass

Optionen für die Verarbeitung der Google Cloud Storage-Objektspeicherklasse.

Enums
STORAGE_CLASS_UNSPECIFIED Das Verhalten der Speicherklasse ist nicht angegeben.
STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT Verwenden Sie die Standardspeicherklasse des Ziel-Buckets.
STORAGE_CLASS_PRESERVE Ursprüngliche Speicherklasse des Objekts beibehalten Dies wird nur für Übertragungen von Google Cloud Storage-Buckets unterstützt. Die Speicherklassen REGIONAL und MULTI_REGIONAL werden STANDARD zugeordnet, damit sie in den Ziel-Bucket geschrieben werden können.
STORAGE_CLASS_STANDARD Legen Sie die Speicherklasse auf „STANDARD“ fest.
STORAGE_CLASS_NEARLINE Legen Sie die Speicherklasse auf NEARLINE fest.
STORAGE_CLASS_COLDLINE Legen Sie die Speicherklasse auf „COLDLINE“ fest.
STORAGE_CLASS_ARCHIVE Legen Sie die Speicherklasse auf „ARCHIVE“ fest.

TemporaryHold

Optionen für die Verwaltung vorübergehender Vorhalte für Google Cloud Storage-Objekte.

Enums
TEMPORARY_HOLD_UNSPECIFIED Das Verhalten bei einer vorübergehenden Vorabankündigung ist nicht angegeben.
TEMPORARY_HOLD_SKIP Legen Sie keinen temporären Hold für das Zielobjekt fest.
TEMPORARY_HOLD_PRESERVE Ursprünglichen temporären Hold-Status des Objekts beibehalten

KmsKey

Optionen für die Verarbeitung der KmsKey-Einstellung für Google Cloud Storage-Objekte.

Enums
KMS_KEY_UNSPECIFIED Das Verhalten von KmsKey ist nicht angegeben.
KMS_KEY_DESTINATION_BUCKET_DEFAULT Verwenden Sie die Standardverschlüsselungseinstellungen des Ziel-Buckets.
KMS_KEY_PRESERVE Behalten Sie den ursprünglichen vom Kunden verwalteten Cloud KMS-Verschlüsselungsschlüssel (CMEK) des Objekts bei, falls vorhanden. Objekte, für die kein Cloud KMS-Verschlüsselungsschlüssel verwendet wird, werden mit den Verschlüsselungseinstellungen des Ziel-Buckets verschlüsselt.

TimeCreated

Optionen zum Umgang mit timeCreated-Metadaten für Google Cloud Storage-Objekte.

Enums
TIME_CREATED_UNSPECIFIED Das Verhalten von „TimeCreated“ ist nicht angegeben.
TIME_CREATED_SKIP Die timeCreated-Metadaten aus dem Quellobjekt werden nicht beibehalten.
TIME_CREATED_PRESERVE_AS_CUSTOM_TIME Die timeCreated- oder lastModified-Metadaten des Quellobjekts werden im Feld customTime im Zielobjekt beibehalten. Hinweis: Alle Werte, die im Feld customTime des Quellobjekts gespeichert sind, werden nicht an das Zielobjekt weitergegeben.