KRM API-Objekt object.gdc.goog/v1

object.gdc.goog/v1

Enthält API-Schemadefinitionen für die API-Gruppe „Object Storage“ v1.

Bucket

Definiert das Schema für die Buckets API.

Wird angezeigt in: - BucketList

Feld Beschreibung
apiVersion String object.gdc.goog/v1
kind String Bucket
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
spec BucketSpec
status BucketStatus

BucketInfo

Definiert das Schema für die BucketInfo API.

Wird angezeigt in: - BucketInfoList

Feld Beschreibung
apiVersion String object.gdc.goog/v1
kind String BucketInfo
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
spec BucketInfoSpec
status BucketInfoStatus

BucketInfoList

Enthält eine Liste von BucketInfos.

Feld Beschreibung
apiVersion String object.gdc.goog/v1
kind String BucketInfoList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
items BucketInfo-Array

BucketInfoSpec

BucketInfoSpec definiert den gewünschten Status der BucketInfo-Ressource.

Wird angezeigt in: - BucketInfo

Feld Beschreibung
description String Die Beschreibung des Bucket-Inhalts.
storageClass ObjectStorageClass Definiert, wie oft auf Daten zugegriffen werden muss. Die verfügbaren Optionen sind Standard und Nearline. Standard eignet sich für aktive Daten, auf die häufig zugegriffen wird, wie Websites, gestreamte Videos und Apps. Sie wird für Daten verwendet, die mindestens 30 Tage lang gespeichert werden können. Nearline ist für Daten geeignet, die mindestens 60 Tage gespeichert werden können, z. B. Datensicherungen und Longtail-Multimedia-Inhalte.
bucketPolicy GlobalBucketPolicy Definiert Richtlinien der Bucket-Ressource. Wenn keine Angabe erfolgt, werden Standardrichtlinien angewendet.
location String Definiert den physischen Ort, an dem sich die Objektdaten im Bucket befinden. Wenn nicht angegeben, wird standardmäßig der Standort verwendet, an dem der Bucket erstellt wird.
bucketName String Der Name des bereitgestellten Buckets ohne Namespace. Dies wird verwendet, um auf den Bucket zu verweisen, wenn lokale Tools und Bibliotheken verwendet werden.
zonalEndpoints String-Array Zonale DNS-Endpunkte, über die der Bucket erreichbar ist. Verwenden Sie diese Endpunkte, wenn ein benutzerdefiniertes Failover erforderlich ist.
globalEndpoint String Globaler Endpunkt, über den der Traffic dynamisch an jede Zone weitergeleitet wird, die Daten für diesen Bucket enthält. Verwenden Sie diesen Endpunkt, wenn ein automatischer Failover erforderlich ist.
region String Die Region, in der der Bucket gespeichert ist.
encryption EncryptionStatus Der Status der Verschlüsselung für den Bucket.
allowDegradedWrites boolean Wird nur für synchrone Buckets verwendet. Gibt an, ob S3-Vorgänge auf die asynchrone Replikation zurückgreifen sollen, weil eine der Replikationszonen nicht verfügbar ist. So wird verhindert, dass synchrone Buckets schreibgeschützt werden, wenn eine der Replikationszonen ausfällt. Wenn leer, wird standardmäßig „false“ verwendet.

BucketInfoStatus

Definiert den beobachteten Status von BucketInfo.

Wird angezeigt in: - BucketInfo

Feld Beschreibung
conditions Bedingungs-Array

BucketList

Enthält eine Liste von Buckets.

Feld Beschreibung
apiVersion String object.gdc.goog/v1
kind String BucketList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
items Bucket-Array

BucketPolicy

Definiert die Richtlinien des Bucket.

Wird angezeigt in: - BucketSpec

Feld Beschreibung
lockingPolicy LockingPolicy Richtlinie für die Objektsperrung. Wenn diese Option festgelegt ist, wird die Objektversionsverwaltung aktiviert und alle im Bucket gespeicherten Objekte unterliegen dieser Richtlinie. Ein gesperrtes Objekt kann erst gelöscht werden, wenn die Sperre abläuft. Kann nur beim Erstellen des Buckets aktiviert und danach nicht mehr deaktiviert werden. Wenn sie nicht aktiviert ist, sind die Objektsperrung und die Versionsverwaltung deaktiviert und können nicht aktiviert werden.
corsPolicy CorsPolicy Richtlinie für benutzerdefinierte CORS-Richtlinien, die für den Bucket festgelegt sind. CorsPolicy muss aktiviert sein, wenn für die Buckets eine zusätzliche CORS-Richtlinie erforderlich ist. Andernfalls hat der Bucket nur die standardmäßige CORS-Richtlinie für die UI-Konsole. CorsPolicy kann jederzeit nach der Erstellung des Buckets hinzugefügt oder geändert werden.
lifecyclePolicy LifecyclePolicy Richtlinie für benutzerdefinierte Lebenszyklusrichtlinie, die für die Nutzergruppe für den Bucket festgelegt ist. LifecyclePolicy kann jederzeit nach dem Erstellen des Buckets hinzugefügt, geändert oder entfernt werden.

BucketSpec

BucketSpec definiert den gewünschten Status der Bucket-Ressource.

Wird angezeigt in: - Bucket

Feld Beschreibung
description String Beschreibung des Bucket-Inhalts.
storageClass ObjectStorageClass Definiert, wie oft auf Daten zugegriffen werden muss. Die verfügbaren Optionen sind Standard und Nearline. Standard eignet sich für aktive Daten, auf die häufig zugegriffen wird, wie Websites, gestreamte Videos und Apps. Sie wird für Daten verwendet, die mindestens 30 Tage lang gespeichert werden können. Nearline ist für Daten geeignet, die mindestens 60 Tage gespeichert werden können, z. B. Datensicherungen und Longtail-Multimedia-Inhalte.
bucketPolicy BucketPolicy Definiert Richtlinien der Bucket-Ressource. Wenn keine Angabe erfolgt, werden Standardrichtlinien angewendet.
location String Definiert den physischen Ort, an dem sich die Objektdaten im Bucket befinden. Wenn nicht angegeben, wird standardmäßig der Standort verwendet, an dem der Bucket erstellt wird.

BucketStatus

Definiert den beobachteten Status des Bucket.

Wird angezeigt in: - Bucket

Feld Beschreibung
fullyQualifiedName String Der Name des bereitgestellten Buckets. Dieser Name wird verwendet, um mit externen Tools und Bibliotheken auf den Bucket zu verweisen.
conditions Bedingungs-Array Gibt den Status des Buckets an. Unterstützte Bedingungen sind BucketReady. Wenn „BucketReady“ True ist, bedeutet das, dass der Bucket bereitgestellt wurde und verwendet werden kann.
endpoint String Der DNS-Endpunkt, über den der Bucket erreichbar ist.
region String Die Region, in der der Bucket gespeichert ist.
encryption EncryptionStatus Der Status der Verschlüsselung für den Bucket.
errorStatus ErrorStatus ErrorStatus enthält die letzten Fehler mit den beobachteten Zeiten.

CorsPolicy

Definiert die Strategie zum Einrichten einer benutzerdefinierten CORS-Richtlinie für den Bucket.

Erscheint in: - BucketPolicy - GlobalBucketPolicy

Feld Beschreibung
enableCorsPolicy boolean Gibt an, ob die benutzerdefinierte Richtlinie für den Bucket gelten soll. Wenn ja, wird die in „CorsDetail“ definierte benutzerdefinierte Richtlinie gelesen. Andernfalls wird „CorsDetail“ nicht verwendet, auch wenn eine benutzerdefinierte Richtlinie eingerichtet ist.
corsDetail CorsRule-Array Details zur benutzerdefinierten CORS-Richtlinie, die festgelegt wird.

CorsRule

Definiert die Informationen, die mit der CORS-Regel verknüpft sind.

Wird angezeigt in: - CorsPolicy

Feld Beschreibung
allowedHeaders String-Array Header, die im Header „Access-Control-Request-Headers“ angegeben sind.
allowedMethods String-Array HTTP-Methoden, die von einem zulässigen Ursprung ausgeführt werden dürfen.
allowedOrigins String-Array Ursprünge, die auf den Bucket zugreifen können.
exposeHeaders String-Array Header in der Antwort, auf die zugegriffen werden kann.
id String Eindeutige Kennung für die Regel. Der Wert darf nicht länger als 255 Zeichen sein.

EncryptionStatus

„EncryptionStatus“ definiert den Status der Verschlüsselung für den Bucket.

Vorkommen: - BucketInfoSpec - BucketStatus

Feld Beschreibung
type EncryptionType Definiert den Verschlüsselungstyp, der für den Bucket verwendet werden soll. Folgende Optionen sind verfügbar: - CMEK: Customer-Managed Encryption Key. Hierbei wird ein KMS-gestützter Schlüssel erstellt, der im HSM verwurzelt ist und für den dem Kunden Kosten in Rechnung gestellt werden. Der Kunde kann über KMS auf diese Schlüssel zugreifen und sie verwalten.
keyRef ObjectReference KeyRef verweist auf den Schlüssel, der als Standardschlüssel zum Verschlüsseln von Objekten im Bucket verwendet wird.

GlobalBucketPolicy

Definiert die Richtlinien des Bucket.

Wird angezeigt in: - BucketInfoSpec

Feld Beschreibung
lockingPolicy LockingPolicy Richtlinie für die Objektsperrung. Wenn diese Option festgelegt ist, wird die Objektversionsverwaltung aktiviert und alle im Bucket gespeicherten Objekte unterliegen dieser Richtlinie. Ein gesperrtes Objekt kann erst gelöscht werden, wenn die Sperre abläuft. Kann nur beim Erstellen des Buckets aktiviert und danach nicht mehr deaktiviert werden.
corsPolicy CorsPolicy Richtlinie für benutzerdefinierte CORS-Richtlinien, die für den Bucket festgelegt sind. CorsPolicy muss aktiviert sein, wenn für die Buckets eine zusätzliche CORS-Richtlinie erforderlich ist. Andernfalls hat der Bucket nur die standardmäßige CORS-Richtlinie für die UI-Konsole. CorsPolicy kann jederzeit nach der Erstellung des Buckets hinzugefügt oder geändert werden.
lifecyclePolicy LifecyclePolicy Richtlinie für benutzerdefinierte Lebenszyklusrichtlinie, die für die Nutzergruppe für den Bucket festgelegt ist. LifecyclePolicy kann jederzeit nach dem Erstellen des Buckets hinzugefügt, geändert oder entfernt werden.

LifecycleExpiration

Wird angezeigt in: - LifecycleRule

Feld Beschreibung
date Zeit Das genaue Datum, an dem die Objekte gelöscht werden sollen.
days Ganzzahl Anzahl der Tage, an denen dieses Objekt der Regel unterliegt.

LifecycleNoncurrentExpiration

Wird angezeigt in: - LifecycleRule

Feld Beschreibung
noncurrentDays Ganzzahl Anzahl der Tage, die ein Objekt nicht aktuell ist, bevor die Lebenszyklusregeln die Aktion ausführen.

LifecyclePolicy

Erscheint in: - BucketPolicy - GlobalBucketPolicy

Feld Beschreibung
enable boolean Gibt an, ob der Nutzer eine benutzerdefinierte Lebenszyklusrichtlinie für den Bucket aktivieren möchte.
lifecycleRules LifecycleRule-Array Besteht aus einer oder mehreren Regeln für die Lebenszykluskonfiguration, mit denen Ablaufaktionen für Objekte im Bucket ausgeführt werden können.

LifecycleRule

Wird angezeigt in: - LifecyclePolicy

Feld Beschreibung
id String Eindeutige Kennung für die Regel. Der Wert darf höchstens 255 Zeichen umfassen.
status LifecycleRuleStatus Status der Lebenszyklusregel. Geben Sie an, ob diese Regel eine Aktion ausführt. Der Status kann jederzeit geändert werden. Nur aktivierte Regeln werden angewendet.
expiration LifecycleExpiration Ablaufverhalten für Objekte in der aktuellen Version. Es muss entweder „Expiration“ oder „NoncurrentExpiration“ oder beides angegeben werden. Regeln ohne Ablaufverhalten werden ignoriert.
noncurrentExpiration LifecycleNoncurrentExpiration Ablaufverhalten für nicht aktuelle Objekte.
filter LifecycleRuleFilter Filtern Sie nach der Regel. Wenn Sie keinen Filter angeben, gilt die Regel für alle Objekte im Bucket.

LifecycleRuleFilter

Definiert den Filter, der für eine Lebenszyklusregel festgelegt werden kann.

Wird angezeigt in: - LifecycleRule

Feld Beschreibung
prefixFilter String Objekte mit dem angegebenen Präfix abgleichen. Ein leerer String für das Präfix bedeutet, dass die Regel auf alle Objekte im Bucket angewendet wird.
tagFilters Tag-Array Objekte mit den angegebenen Tags abgleichen. Das Tag für das Objekt muss sowohl mit dem Schlüssel als auch mit dem Wert genau übereinstimmen.

LifecycleRuleStatus

Zugrunde liegender Typ:string

Wird angezeigt in: - LifecycleRule

LockingPolicy

Definiert die Strategie zum Sperren der Objekte des Buckets.

Erscheint in: - BucketPolicy - GlobalBucketPolicy

Feld Beschreibung
defaultObjectRetentionDays Ganzzahl Gibt die Mindestanzahl an Tagen an, für die jede Version jedes Objekts aufbewahrt wird. Ein Objekt kann während des Aufbewahrungszeitraums nicht gelöscht werden. Wenn ein Bucket Objekte enthält, kann er ebenfalls nicht gelöscht werden. Wenn kein Wert angegeben ist, wird keine Standard-Aufbewahrungsdauer für Objekte festgelegt. Kann nach der Erstellung geändert werden. Die Änderung wird jedoch nur für neue Objekte und Versionen wirksam. Für vorhandene Objekte und Versionen wird weiterhin der vorherige Wert verwendet.

S3CredentialRotationRequest

S3CredentialRotationRequest ist das Schema für die S3CredentialRotationRequests API.

Erscheint in: - S3CredentialRotationRequestList

Feld Beschreibung
apiVersion String object.gdc.goog/v1
kind String S3CredentialRotationRequest
metadata ObjectMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
spec S3CredentialRotationRequestSpec
status S3CredentialRotationRequestStatus

S3CredentialRotationRequestList

S3CredentialRotationRequestList enthält eine Liste von S3CredentialRotationRequest

Feld Beschreibung
apiVersion String object.gdc.goog/v1
kind String S3CredentialRotationRequestList
metadata ListMeta Informationen zu den Feldern von metadata finden Sie in der API-Dokumentation zu Kubernetes.
items S3CredentialRotationRequest-Array

S3CredentialRotationRequestSpec

S3CredentialRotationRequestSpec definiert den gewünschten Status einer S3CredentialRotationRequest. Mit dieser Spezifikation wird die Rotation von S3-Anmeldedaten initiiert, die in einem Kubernetes Secret gespeichert sind.

Erscheint in: - S3CredentialRotationRequest

Feld Beschreibung
secretName String „SecretName“ ist der Name des Kubernetes-Secrets, das die S3-Anmeldedaten enthält, die rotiert werden müssen. Das Secret muss im selben Namespace wie diese S3CredentialRotationRequest vorhanden sein.
expirationDelay Dauer ExpirationDelay gibt die Dauer an, für die der alte, rotierte S3-Schlüssel nach der Erstellung des neuen Schlüssels gültig bleibt. So können Clients und Anwendungen in Ruhe auf die neuen Anmeldedaten umgestellt werden. Wenn dieser Wert nicht angegeben ist, wird er von einem Webhook für Standardwerte auf 72 Stunden festgelegt. Der Wert „0s“ gibt an, dass der alte Schlüssel sofort nach der Aktivierung des neuen Schlüssels widerrufen werden soll. Das Format ist ein Dauerstring, der von der Funktion „time.ParseDuration“ von Go geparst werden kann. Beispiele: „72h“, „90m“, „30s“. Einheiten wie „d“ für Tage werden nicht unterstützt. Weitere Informationen zum Format finden Sie unter https://pkg.go.dev/time#ParseDuration.
requestTTL Dauer „RequestTTL“ definiert die Gültigkeitsdauer (TTL) für dieses „S3CredentialRotationRequest“-Objekt selbst. Der TTL-Timer beginnt, nachdem die Rotation der Anmeldedaten abgeschlossen ist, d.h. wenn der Status RotationCompleted in True geändert wird. Nach Ablauf dieser Zeit wird das Anfrageobjekt automatisch vom System gelöscht. Bei diesem Mechanismus wird die Anfrage für einen konfigurierbaren Zeitraum als Audit-Datensatz aufbewahrt. Wenn kein Wert angegeben ist, wird dieser Wert von einem Standard-Webhook standardmäßig auf 90 Tage festgelegt. Das Format ist ein Dauerstring, der von der Funktion „time.ParseDuration“ von Go geparst werden kann. Beispiele: „2160h“ (für 90 Tage), „72h“, „30m“. Einheiten wie „d“ für Tage werden nicht unterstützt. Weitere Informationen zum Format finden Sie unter https://pkg.go.dev/time#ParseDuration.

S3CredentialRotationRequestStatus

„S3CredentialRotationRequestStatus“ definiert den beobachteten Status einer „S3CredentialRotationRequest“. Sie gibt Feedback zum Fortschritt und Ergebnis des Prozesses zur Anmeldedatenrotation.

Erscheint in: - S3CredentialRotationRequest

Feld Beschreibung
conditions Bedingungs-Array „Conditions“ entspricht den neuesten verfügbaren Beobachtungen zum Status der Rotationsanfrage. Sie enthält eine detaillierte Aufschlüsselung des Rotationsprozesses, einschließlich der aktuellen Phase und aller Fehler, die möglicherweise aufgetreten sind.
oldKeyRevocationTimestamp Zeit OldKeyRevocationTimestamp ist der Zeitstempel, zu dem der alte, rotierte S3-Schlüssel dauerhaft aus dem Backend-Speichersystem widerrufen werden soll. Diese Zeit wird berechnet, indem der ExpirationDelay zur LastTransitionTime der Bedingung „RotationCompleted“ addiert wird.

Tag

Definiert die Tags für Objekte, die vom Lebenszyklusfilter verwendet werden können.

Wird angezeigt in: - LifecycleRuleFilter

Feld Beschreibung
key String
value String