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 ( |
Felder | |
---|---|
overwriteObjectsAlreadyExistingInSink |
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 |
Gibt an, ob Objekte, die nur im Datensink vorhanden sind, gelöscht werden sollen. Hinweis:Diese Option und |
deleteObjectsFromSourceAfterTransfer |
Gibt an, ob Objekte aus der Quelle gelöscht werden sollen, nachdem sie in den Zielspeicher übertragen wurden. Hinweis:Diese Option und |
overwriteWhen |
Gibt an, wann Objekte überschrieben werden, die bereits im Datenablauf vorhanden sind. Wenn nicht festgelegt, wird das Überschreibungsverhalten durch |
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 ( |
Felder | |
---|---|
symlink |
Gibt an, wie Symlinks bei der Übertragung behandelt werden sollen. Symlinks werden standardmäßig nicht beibehalten. Nur für Übertragungen mit POSIX-Dateisystemen anwendbar, bei anderen Übertragungen wird die Option ignoriert. |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
timeCreated |
Gibt an, wie die |
Symlink
Ob Symlinks bei einem Übertragungsjob übersprungen oder beibehalten werden sollen.
Enums | |
---|---|
SYMLINK_UNSPECIFIED |
Das Verhalten von Symbollinks ist nicht angegeben. |
SYMLINK_SKIP |
Symlinks werden während eines Übertragungsjobs nicht beibehalten. |
SYMLINK_PRESERVE |
Symlinks bei einem Übertragungsjob beibehalten |
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. |