KRM API object.gdc.goog/v1

object.gdc.goog/v1

Contiene le definizioni dello schema API per il gruppo API v1 Object Storage.

Bucket

Definisce lo schema per l'API Buckets.

Visualizzato in: - BucketList

Campo Descrizione
apiVersion stringa object.gdc.goog/v1
kind stringa Bucket
metadata ObjectMeta Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
spec BucketSpec
status BucketStatus

BucketInfo

Definisce lo schema per l'API BucketInfo.

Appare in: - BucketInfoList

Campo Descrizione
apiVersion stringa object.gdc.goog/v1
kind stringa BucketInfo
metadata ObjectMeta Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
spec BucketInfoSpec
status BucketInfoStatus

BucketInfoList

Contiene un elenco di BucketInfo.

Campo Descrizione
apiVersion stringa object.gdc.goog/v1
kind stringa BucketInfoList
metadata ListMeta Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
items BucketInfo array

BucketInfoSpec

BucketInfoSpec definisce lo stato desiderato della risorsa BucketInfo.

Appare in: - BucketInfo

Campo Descrizione
description stringa La descrizione dei contenuti del bucket.
storageClass ObjectStorageClass Definisce la frequenza con cui è necessario accedere ai dati. Le opzioni disponibili includono Standard e Nearline. Standard è la scelta ideale per i dati ad accesso frequente, tra cui siti web, video in streaming e app mobile. Viene utilizzato per i dati che possono essere archiviati per almeno 30 giorni. Nearline è adatto ai dati che possono essere archiviati per almeno 60 giorni, inclusi dati di backup e contenuti multimediali long-tail.
bucketPolicy GlobalBucketPolicy Definisce le policy della risorsa bucket. Se non specificate, vengono applicate le norme predefinite.
location stringa Definisce il luogo fisico in cui risiedono i dati degli oggetti nel bucket. Se non specificato, il valore predefinito è la località in cui viene creato il bucket.
bucketName stringa Il nome senza spazio dei nomi del bucket di cui è stato eseguito il provisioning. Viene utilizzato per fare riferimento al bucket quando utilizzi strumenti e librerie locali.
zonalEndpoints array di stringhe Endpoint DNS di zona in cui è raggiungibile il bucket. Utilizza questi endpoint se è necessario un failover personalizzato.
globalEndpoint stringa Endpoint globale che indirizzerà dinamicamente il traffico a qualsiasi zona che contenga dati per questo bucket. Utilizza questo endpoint se è necessario il failover automatico.
region stringa La regione in cui è archiviato il bucket.
encryption EncryptionStatus Lo stato della crittografia nel bucket.
allowDegradedWrites boolean Utilizzato solo per i bucket sincroni. Determina se le operazioni S3 devono essere ripristinate alla replica asincrona a causa dell'indisponibilità di una delle zone di replica. In questo modo, i bucket sincroni non diventano di sola lettura nel caso in cui una delle zone di replica non sia disponibile. Se è vuoto, il valore predefinito è false.

BucketInfoStatus

Definisce lo stato osservato di BucketInfo.

Appare in: - BucketInfo

Campo Descrizione
conditions Condition array

BucketList

Contiene un elenco di bucket.

Campo Descrizione
apiVersion stringa object.gdc.goog/v1
kind stringa BucketList
metadata ListMeta Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
items Array di bucket

BucketPolicy

Definisce le policy del bucket.

Appare in: - BucketSpec

Campo Descrizione
lockingPolicy LockingPolicy Norme per il blocco degli oggetti. Se impostato, il controllo delle versioni degli oggetti è abilitato e tutti gli oggetti archiviati nel bucket saranno soggetti a questo criterio. Un oggetto bloccato non può essere eliminato fino alla scadenza del blocco. Può essere abilitata solo durante la creazione del bucket e non può essere disattivata in un secondo momento. Se non è abilitata, il blocco e il controllo delle versioni degli oggetti sono disabilitati e non possono essere abilitati.
corsPolicy CorsPolicy Policy per il set di utenti della policy CORS personalizzata sul bucket. CorsPolicy deve essere abilitata quando è necessaria una policy CORS aggiuntiva sui bucket. In caso contrario, il bucket avrà solo la policy CORS predefinita della console UI. CorsPolicy può sempre essere aggiunta o modificata in un secondo momento dopo la creazione del bucket.
lifecyclePolicy LifecyclePolicy Policy per il set di utenti della policy del ciclo di vita personalizzata sul bucket. LifecyclePolicy può sempre essere aggiunta, modificata o rimossa in un secondo momento dopo la creazione del bucket.

BucketSpec

BucketSpec definisce lo stato desiderato della risorsa Bucket.

Visualizzato in: - Bucket

Campo Descrizione
description stringa Descrizione dei contenuti del bucket.
storageClass ObjectStorageClass Definisce la frequenza con cui è necessario accedere ai dati. Le opzioni disponibili includono Standard e Nearline. Standard è la scelta ideale per i dati ad accesso frequente, tra cui siti web, video in streaming e app mobile. Viene utilizzato per i dati che possono essere archiviati per almeno 30 giorni. Nearline è adatto ai dati che possono essere archiviati per almeno 60 giorni, inclusi dati di backup e contenuti multimediali long-tail.
bucketPolicy BucketPolicy Definisce le policy della risorsa bucket. Se non specificate, vengono applicate le norme predefinite.
location stringa Definisce il luogo fisico in cui risiedono i dati degli oggetti nel bucket. Se non specificato, il valore predefinito è la località in cui viene creato il bucket.

BucketStatus

Definisce lo stato osservato del bucket.

Visualizzato in: - Bucket

Campo Descrizione
fullyQualifiedName stringa Il nome del bucket di cui è stato eseguito il provisioning. Questo nome viene utilizzato per fare riferimento al bucket quando si utilizzano strumenti e librerie esterni.
conditions Condition array Specifica lo stato del bucket. Le condizioni supportate includono BucketReady. Se BucketReady è True, significa che è stato eseguito il provisioning del bucket ed è pronto per l'uso.
endpoint stringa L'endpoint DNS in cui è raggiungibile il bucket.
region stringa La regione in cui è archiviato il bucket.
encryption EncryptionStatus Lo stato della crittografia nel bucket.
errorStatus ErrorStatus ErrorStatus contiene gli errori più recenti con i tempi osservati inclusi.

CorsPolicy

Definisce la strategia per configurare la policy CORS personalizzata sul bucket.

Visualizzato in: - BucketPolicy - GlobalBucketPolicy

Campo Descrizione
enableCorsPolicy boolean Definisce se l'utente vuole che la policy personalizzata abbia effetto sul bucket. In caso affermativo, verrà letto il criterio personalizzato definito in CorsDetail. In caso contrario, CorsDetail non verrà utilizzato anche se è stata configurata una norma personalizzata.
corsDetail CorsRule array Dettagli della policy CORS personalizzata in fase di impostazione.

CorsRule

Definisce le informazioni relative alla regola CORS.

Visualizzato in: - CorsPolicy

Campo Descrizione
allowedHeaders array di stringhe Intestazioni specificate nell'intestazione Access-Control-Request-Headers.
allowedMethods array di stringhe Metodi HTTP consentiti per l'esecuzione da parte di un'origine consentita.
allowedOrigins array di stringhe Origini che possono accedere al bucket.
exposeHeaders array di stringhe Intestazioni nella risposta a cui è possibile accedere.
id stringa Identificatore univoco della regola. Il valore non può contenere più di 255 caratteri.

EncryptionStatus

EncryptionStatus definisce lo stato della crittografia nel bucket.

Visualizzato in: - BucketInfoSpec - BucketStatus

Campo Descrizione
type EncryptionType Definisce il tipo di crittografia da utilizzare per il bucket. Le opzioni disponibili sono: - CMEK: chiave di crittografia gestita dal cliente che crea una chiave supportata da KMS radicata nell'HSM per cui viene addebitato il costo al cliente. Il cliente può accedere a queste chiavi e gestirle tramite KMS.
keyRef ObjectReference KeyRef fa riferimento alla chiave utilizzata come chiave predefinita per criptare gli oggetti nel bucket.

GlobalBucketPolicy

Definisce le policy del bucket.

Appare in: - BucketInfoSpec

Campo Descrizione
lockingPolicy LockingPolicy Norme per il blocco degli oggetti. Se impostato, il controllo delle versioni degli oggetti è abilitato e tutti gli oggetti archiviati nel bucket saranno soggetti a questo criterio. Un oggetto bloccato non può essere eliminato fino alla scadenza del blocco. Può essere abilitata solo durante la creazione del bucket e non può essere disattivata in un secondo momento.
corsPolicy CorsPolicy Policy per il set di utenti della policy CORS personalizzata sul bucket. CorsPolicy deve essere abilitata quando è necessaria una policy CORS aggiuntiva sui bucket. In caso contrario, il bucket avrà solo la policy CORS predefinita della console UI. CorsPolicy può sempre essere aggiunta o modificata in un secondo momento dopo la creazione del bucket.
lifecyclePolicy LifecyclePolicy Policy per il set di utenti della policy del ciclo di vita personalizzata sul bucket. LifecyclePolicy può sempre essere aggiunta, modificata o rimossa in un secondo momento dopo la creazione del bucket.

LifecycleExpiration

Visualizzato in: - LifecycleRule

Campo Descrizione
date Ora Data specifica in cui gli oggetti devono essere eliminati.
days numero intero Il numero di giorni in cui questo oggetto è soggetto alla regola.

LifecycleNoncurrentExpiration

Visualizzato in: - LifecycleRule

Campo Descrizione
noncurrentDays numero intero Numero di giorni in cui un oggetto è non corrente prima che le regole del ciclo di vita eseguano l'azione.

LifecyclePolicy

Visualizzato in: - BucketPolicy - GlobalBucketPolicy

Campo Descrizione
enable boolean Definisce se l'utente vuole attivare la policy del ciclo di vita personalizzata sul bucket.
lifecycleRules Array LifecycleRule È costituita da una o più regole di configurazione del ciclo di vita che possono eseguire l'azione di scadenza sugli oggetti nel bucket.

LifecycleRule

Viene visualizzato in: - LifecyclePolicy

Campo Descrizione
id stringa Identificatore univoco della regola. Il valore non può contenere più di 255 caratteri.
status LifecycleRuleStatus Stato della regola del ciclo di vita. Indica se questa regola esegue un'azione. Lo stato può essere modificato in qualsiasi momento e solo la regola abilitata avrà effetto.
expiration LifecycleExpiration Comportamento di scadenza per gli oggetti nella versione corrente. È necessario fornire la data di scadenza o la data di scadenza non corrente oppure entrambe. La regola senza comportamento di scadenza verrà ignorata.
noncurrentExpiration LifecycleNoncurrentExpiration Comportamento di scadenza per gli oggetti non correnti.
filter LifecycleRuleFilter Filtra la regola. Un filtro vuoto indica che la regola si applica a tutti gli oggetti nel bucket.

LifecycleRuleFilter

Definisce il filtro che può essere impostato sulla regola del ciclo di vita.

Visualizzato in: - LifecycleRule

Campo Descrizione
prefixFilter stringa Corrispondono agli oggetti con il prefisso fornito. Una stringa vuota di prefisso significa che la regola si applica a tutti gli oggetti nel bucket.
tagFilters Array Tag Abbina gli oggetti ai tag forniti. Il tag sull'oggetto deve corrispondere esattamente sia alla chiave che al valore.

LifecycleRuleStatus

Tipo sottostante: string

Visualizzato in: - LifecycleRule

LockingPolicy

Definisce la strategia per bloccare gli oggetti del bucket.

Visualizzato in: - BucketPolicy - GlobalBucketPolicy

Campo Descrizione
defaultObjectRetentionDays numero intero Specifica il numero minimo di giorni di conservazione di ogni versione di ogni oggetto. Un oggetto non può essere eliminato durante il periodo di conservazione. Se un bucket contiene oggetti, non può essere eliminato. Se non specificato, non viene impostato alcun periodo di conservazione degli oggetti predefinito. Può essere modificato dopo la creazione, ma la modifica avrà effetto solo per i nuovi oggetti e le nuove versioni. Gli oggetti e le versioni esistenti continueranno a utilizzare il valore precedente.

S3CredentialRotationRequest

S3CredentialRotationRequest è lo schema per l'API S3CredentialRotationRequests

Visualizzato in: - S3CredentialRotationRequestList

Campo Descrizione
apiVersion stringa object.gdc.goog/v1
kind stringa S3CredentialRotationRequest
metadata ObjectMeta Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
spec S3CredentialRotationRequestSpec
status S3CredentialRotationRequestStatus

S3CredentialRotationRequestList

S3CredentialRotationRequestList contiene un elenco di S3CredentialRotationRequest

Campo Descrizione
apiVersion stringa object.gdc.goog/v1
kind stringa S3CredentialRotationRequestList
metadata ListMeta Per i campi di metadata, consulta la documentazione dell'API Kubernetes.
items S3CredentialRotationRequest array

S3CredentialRotationRequestSpec

S3CredentialRotationRequestSpec definisce lo stato desiderato di una S3CredentialRotationRequest. Questa specifica viene utilizzata per avviare la rotazione delle credenziali S3 archiviate in un secret Kubernetes.

Visualizzato in: - S3CredentialRotationRequest

Campo Descrizione
secretName stringa SecretName è il nome del secret Kubernetes contenente le credenziali S3 che devono essere ruotate. Il secret deve esistere nello stesso spazio dei nomi di questa S3CredentialRotationRequest.
expirationDelay Durata ExpirationDelay specifica la durata per cui la vecchia chiave S3 ruotata rimarrà valida dopo la creazione della nuova chiave. Ciò consente un periodo di transizione graduale per i client e le applicazioni per passare alle nuove credenziali. Se non specificato, questo valore viene impostato per impostazione predefinita da un webhook predefinito su 72 ore. Un valore di "0s" indica che la vecchia chiave deve essere revocata immediatamente dopo l'attivazione della nuova chiave. Il formato è una stringa di durata analizzabile dalla funzione time.ParseDuration di Go. Ad esempio, "72h", "90m", "30s". Tieni presente che le unità come "d" per i giorni non sono supportate. Per ulteriori dettagli sul formato, visita la pagina https://pkg.go.dev/time#ParseDuration.
requestTTL Durata RequestTTL definisce la durata (TTL) per questo oggetto S3CredentialRotationRequest. Il timer TTL inizia dopo il completamento della rotazione delle credenziali (ovvero quando la condizione di stato RotationCompleted diventa True). Dopo questo periodo, l'oggetto richiesta verrà raccolto automaticamente dal sistema. Questo meccanismo conserva la richiesta come record di controllo per un periodo configurabile. Se non specificato, questo valore viene impostato su 90 giorni da un webhook predefinito. Il formato è una stringa di durata analizzabile dalla funzione time.ParseDuration di Go. Ad esempio, "2160h" (per 90 giorni), "72h", "30m". Tieni presente che le unità come "d" per i giorni non sono supportate. Per ulteriori dettagli sul formato, visita la pagina https://pkg.go.dev/time#ParseDuration.

S3CredentialRotationRequestStatus

S3CredentialRotationRequestStatus definisce lo stato osservato di una S3CredentialRotationRequest. Fornisce feedback sull'avanzamento e sul risultato della procedura di rotazione delle credenziali.

Visualizzato in: - S3CredentialRotationRequest

Campo Descrizione
conditions Condition array Conditions rappresenta le ultime osservazioni disponibili dello stato della richiesta di rotazione. Fornisce un'analisi dettagliata del processo di rotazione, inclusa la fase attuale ed eventuali errori che potrebbero essersi verificati.
oldKeyRevocationTimestamp Ora OldKeyRevocationTimestamp è il timestamp in cui è pianificata la revoca definitiva della vecchia chiave S3 ruotata dal sistema di archiviazione backend. Questo periodo di tempo viene calcolato aggiungendo ExpirationDelay a LastTransitionTime della condizione RotationCompleted.

Tag

Definisce i tag sull'oggetto che possono essere utilizzati dal filtro del ciclo di vita.

Visualizzato in: - LifecycleRuleFilter

Campo Descrizione
key stringa
value stringa