KRM API object.gdc.goog/v1

object.gdc.goog/v1

Contém definições de esquemas de API para o grupo de APIs v1 Object Storage.

Grupo

Define o esquema para a API Buckets.

Aparece em: - BucketList

Campo Descrição
apiVersion string object.gdc.goog/v1
kind string Bucket
metadata ObjectMeta Consulte a documentação da API Kubernetes para os campos de metadata.
spec BucketSpec
status BucketStatus

BucketInfo

Define o esquema para a API BucketInfo.

Aparece em: - BucketInfoList

Campo Descrição
apiVersion string object.gdc.goog/v1
kind string BucketInfo
metadata ObjectMeta Consulte a documentação da API Kubernetes para os campos de metadata.
spec BucketInfoSpec
status BucketInfoStatus

BucketInfoList

Contém uma lista de BucketInfos.

Campo Descrição
apiVersion string object.gdc.goog/v1
kind string BucketInfoList
metadata ListMeta Consulte a documentação da API Kubernetes para os campos de metadata.
items BucketInfo

BucketInfoSpec

BucketInfoSpec define o estado pretendido do recurso BucketInfo.

Aparece em: - BucketInfo

Campo Descrição
description string A descrição do conteúdo do contentor.
storageClass ObjectStorageClass Define a frequência com que os dados têm de ser acedidos. As opções disponíveis incluem Standard e Nearline. Standard é adequado para dados ativos acedidos com frequência, como Websites, streaming de vídeos e apps para dispositivos móveis. É usado para dados que podem ser armazenados durante, pelo menos, 30 dias. Nearline é adequado para dados que podem ser armazenados durante, pelo menos, 60 dias, incluindo a cópia de segurança de dados e conteúdo multimédia de cauda longa.
bucketPolicy GlobalBucketPolicy Define as políticas do recurso de contentor. Se não for especificado, são aplicadas as políticas predefinidas.
location string Define o local físico onde residem os dados de objetos no contentor. Se não for especificado, o valor predefinido é a localização em que o contentor está a ser criado.
bucketName string O nome não pertencente ao espaço de nomes do contentor aprovisionado. Isto é usado para se referir ao contentor quando usa ferramentas e bibliotecas locais.
zonalEndpoints matriz de strings Pontos finais de DNS zonais nos quais o contentor é alcançável. Use estes pontos finais se for necessária uma comutação por falha personalizada.
globalEndpoint string Ponto final global que encaminha dinamicamente o tráfego para qualquer zona que contenha dados para este contentor. Use este ponto final se for necessária a ativação pós-falha automática.
region string A região onde o contentor está armazenado.
encryption EncryptionStatus O estado da encriptação no contentor.
allowDegradedWrites booleano Usado apenas para buckets síncronos. Determina se as operações do S3 devem reverter para a replicação assíncrona devido a uma das zonas de replicação estar indisponível. Isto impede que os contentores síncronos se tornem só de leitura caso uma das zonas de replicação esteja inativa. Se estiver vazio, o valor predefinido é false.

BucketInfoStatus

Define o estado observado do BucketInfo.

Aparece em: - BucketInfo

Campo Descrição
conditions Matriz de condições

BucketList

Contém uma lista de contentores.

Campo Descrição
apiVersion string object.gdc.goog/v1
kind string BucketList
metadata ListMeta Consulte a documentação da API Kubernetes para os campos de metadata.
items Matriz de segmentos

BucketPolicy

Define as políticas do contentor.

Aparece em: - BucketSpec

Campo Descrição
lockingPolicy LockingPolicy Política de bloqueio de objetos. Quando definida, a criação de versões de objetos é ativada e todos os objetos armazenados no contentor estão sujeitos a esta política. Não é possível eliminar um objeto bloqueado até o bloqueio expirar. Só pode ser ativado quando cria o contentor e não pode ser desativado posteriormente. Quando não está ativada, o bloqueio de objetos e o controlo de versões estão desativados e não podem ser ativados.
corsPolicy CorsPolicy Política para a política CORS personalizada definida pelo utilizador no contentor. A CorsPolicy tem de estar ativada quando for necessária uma política do CORS adicional nos contentores. Caso contrário, o contentor só tem a política de CORS da consola de IU predefinida. A CorsPolicy pode sempre ser adicionada ou modificada mais tarde, após a criação do contentor.
lifecyclePolicy LifecyclePolicy Política para o conjunto de utilizadores da política de ciclo de vida personalizada no contentor. A LifecyclePolicy pode sempre ser adicionada, modificada ou removida mais tarde, após a criação do contentor.

BucketSpec

BucketSpec define o estado pretendido do recurso Bucket.

Aparece em: - Contentor

Campo Descrição
description string Descrição do conteúdo do contentor.
storageClass ObjectStorageClass Define a frequência com que os dados têm de ser acedidos. As opções disponíveis incluem Standard e Nearline. Standard é adequado para dados ativos acedidos com frequência, como Websites, streaming de vídeos e apps para dispositivos móveis. É usado para dados que podem ser armazenados durante, pelo menos, 30 dias. Nearline é adequado para dados que podem ser armazenados durante, pelo menos, 60 dias, incluindo a cópia de segurança de dados e conteúdo multimédia de cauda longa.
bucketPolicy BucketPolicy Define as políticas do recurso de contentor. Se não for especificado, são aplicadas as políticas predefinidas.
location string Define o local físico onde residem os dados de objetos no contentor. Se não for especificado, o valor predefinido é a localização em que o contentor está a ser criado.

BucketStatus

Define o estado observado do contentor.

Aparece em: - Contentor

Campo Descrição
fullyQualifiedName string O nome do contentor aprovisionado. Este nome é usado para fazer referência ao contentor quando usa ferramentas e bibliotecas externas.
conditions Matriz de condições Especifica o estado do contentor. As condições suportadas incluem BucketReady. Se BucketReady for True, indica que o contentor foi aprovisionado e está pronto para ser usado.
endpoint string O ponto final de DNS no qual o contentor é alcançável.
region string A região onde o contentor está armazenado.
encryption EncryptionStatus O estado da encriptação no contentor.
errorStatus ErrorStatus ErrorStatus contém os erros mais recentes com as horas observadas incluídas.

CorsPolicy

Define a estratégia para configurar a política de CORS personalizada no contentor.

Aparece em: - BucketPolicy - GlobalBucketPolicy

Campo Descrição
enableCorsPolicy booleano Define se o utilizador quer que a política personalizada entre em vigor no contentor. Se sim, a política personalizada definida em CorsDetail é lida. Caso contrário, o CorsDetail não seria usado, mesmo que tivesse uma política personalizada configurada.
corsDetail Matriz CorsRule Detalhes da política de CORS personalizada que está a ser definida.

CorsRule

Define as informações relacionadas com a regra CORS.

Aparece em: - CorsPolicy

Campo Descrição
allowedHeaders matriz de strings Cabeçalhos especificados no cabeçalho Access-Control-Request-Headers.
allowedMethods matriz de strings Métodos HTTP que podem ser executados por uma origem permitida.
allowedOrigins matriz de strings Origens que podem aceder ao contentor.
exposeHeaders matriz de strings Não é possível aceder aos cabeçalhos na resposta.
id string Identificador exclusivo da regra. O valor não pode ter mais de 255 carateres.

EncryptionStatus

EncryptionStatus define o estado da encriptação no contentor.

Aparece em: - BucketInfoSpec - BucketStatus

Campo Descrição
type EncryptionType Define o tipo de encriptação a usar para o contentor. As opções disponíveis são: - CMEK: chave de encriptação gerida pelo cliente que cria uma chave suportada pelo KMS baseada no HSM pelo qual o cliente é faturado. O cliente pode aceder a estas chaves e geri-las através do KMS.
keyRef ObjectReference KeyRef faz referência à chave que é usada como chave predefinida para encriptar objetos no contentor.

GlobalBucketPolicy

Define as políticas do contentor.

Aparece em: - BucketInfoSpec

Campo Descrição
lockingPolicy LockingPolicy Política de bloqueio de objetos. Quando definida, a criação de versões de objetos é ativada e todos os objetos armazenados no contentor estão sujeitos a esta política. Não é possível eliminar um objeto bloqueado até o bloqueio expirar. Só pode ser ativado quando cria o contentor e não pode ser desativado posteriormente.
corsPolicy CorsPolicy Política para a política CORS personalizada definida pelo utilizador no contentor. A CorsPolicy tem de estar ativada quando for necessária uma política do CORS adicional nos contentores. Caso contrário, o contentor só tem a política de CORS da consola de IU predefinida. A CorsPolicy pode sempre ser adicionada ou modificada mais tarde, após a criação do contentor.
lifecyclePolicy LifecyclePolicy Política para o conjunto de utilizadores da política de ciclo de vida personalizada no contentor. A LifecyclePolicy pode sempre ser adicionada, modificada ou removida mais tarde, após a criação do contentor.

LifecycleExpiration

Aparece em: - LifecycleRule

Campo Descrição
date Hora Data específica em que os objetos devem ser eliminados.
days número inteiro Número de dias em que este objeto está sujeito à regra.

LifecycleNoncurrentExpiration

Aparece em: - LifecycleRule

Campo Descrição
noncurrentDays número inteiro Número de dias em que um objeto está desatualizado antes de as regras do ciclo de vida tomarem medidas.

LifecyclePolicy

Aparece em: - BucketPolicy - GlobalBucketPolicy

Campo Descrição
enable booleano Define se o utilizador quer ativar a política de ciclo de vida personalizada no contentor.
lifecycleRules LifecycleRule Consiste numa ou mais regras de configuração do ciclo de vida que podem tomar medidas de expiração em objetos no contentor.

LifecycleRule

Aparece em: - LifecyclePolicy

Campo Descrição
id string Identificador exclusivo da regra. O valor não pode ter mais de 255 carateres.
status LifecycleRuleStatus Estado da regra do ciclo de vida. Indique se esta regra toma medidas. O estado pode ser sempre alterado, e apenas a regra ativada tem efeito.
expiration LifecycleExpiration Comportamento de expiração dos objetos na versão atual. Deve fornecer a data de validade ou a data de validade não atual, ou ambas. A regra sem comportamento de validade seria ignorada.
noncurrentExpiration LifecycleNoncurrentExpiration Comportamento de expiração para objetos não atuais.
filter LifecycleRuleFilter Filtre a regra. Um filtro vazio significa que a regra se aplica a todos os objetos no contentor.

LifecycleRuleFilter

Define o filtro que pode ser definido na regra do ciclo de vida.

Aparece em: - LifecycleRule

Campo Descrição
prefixFilter string Faça corresponder objetos com o prefixo fornecido. Uma string vazia de prefixo significa que se aplica a todos os objetos no contentor.
tagFilters Matriz de etiquetas Fazer corresponder objetos com etiquetas fornecidas. A etiqueta no objeto tem de corresponder exatamente à chave e ao valor.

LifecycleRuleStatus

Tipo subjacente: string

Aparece em: - LifecycleRule

LockingPolicy

Define a estratégia para bloquear os objetos do contentor.

Aparece em: - BucketPolicy - GlobalBucketPolicy

Campo Descrição
defaultObjectRetentionDays número inteiro Especifica o número mínimo de dias durante os quais cada versão de cada objeto é retida. Não é possível eliminar um objeto durante o período de retenção. Se um contentor tiver algum objeto, também não pode ser eliminado. Quando não é especificado, não é definido nenhum período de retenção de objetos predefinido. Pode ser modificado após a criação. No entanto, a alteração só entra em vigor para novos objetos e versões. Os objetos e as versões existentes vão continuar a usar o valor anterior.

S3CredentialRotationRequest

S3CredentialRotationRequest é o esquema da API S3CredentialRotationRequests

Aparece em: - S3CredentialRotationRequestList

Campo Descrição
apiVersion string object.gdc.goog/v1
kind string S3CredentialRotationRequest
metadata ObjectMeta Consulte a documentação da API Kubernetes para os campos de metadata.
spec S3CredentialRotationRequestSpec
status S3CredentialRotationRequestStatus

S3CredentialRotationRequestList

S3CredentialRotationRequestList contém uma lista de S3CredentialRotationRequest

Campo Descrição
apiVersion string object.gdc.goog/v1
kind string S3CredentialRotationRequestList
metadata ListMeta Consulte a documentação da API Kubernetes para os campos de metadata.
items S3CredentialRotationRequest

S3CredentialRotationRequestSpec

S3CredentialRotationRequestSpec define o estado pretendido de um S3CredentialRotationRequest. Esta especificação é usada para iniciar a rotação das credenciais do S3 armazenadas num segredo do Kubernetes.

Aparece em: - S3CredentialRotationRequest

Campo Descrição
secretName string SecretName é o nome do Secret do Kubernetes que contém as credenciais do S3 que têm de ser rodadas. O segredo tem de existir no mesmo espaço de nomes que este S3CredentialRotationRequest.
expirationDelay Duração ExpirationDelay especifica a duração durante a qual a chave S3 antiga e rotativa permanece válida após a criação da nova chave. Isto permite um período de transição gradual para que os clientes e as aplicações mudem para as novas credenciais. Se não for especificado, este valor é predefinido por um webhook de predefinição para 72 horas. Um valor de "0s" indica que a chave antiga deve ser revogada imediatamente após a ativação da nova chave. O formato é uma string de duração analisável pela função time.ParseDuration do Go. Por exemplo, "72h", "90m", "30s". Tenha em atenção que as unidades, como "d" para dias, não são suportadas. Consulte https://pkg.go.dev/time#ParseDuration para ver mais detalhes sobre o formato.
requestTTL Duração RequestTTL define o tempo de vida (TTL) para este objeto S3CredentialRotationRequest. O temporizador TTL começa após a rotação das credenciais estar concluída (ou seja, quando a condição de estado RotationCompleted passa a True). Após esta duração, o objeto de pedido é recolhido automaticamente pelo sistema. Este mecanismo preserva o pedido como um registo de auditoria durante um período configurável. Se não for especificado, este valor é predefinido por um webhook de predefinição para 90 dias. O formato é uma string de duração analisável pela função time.ParseDuration do Go. Por exemplo, "2160h" (para 90 dias), "72h", "30m". Tenha em atenção que as unidades, como "d" para dias, não são suportadas. Consulte https://pkg.go.dev/time#ParseDuration para ver mais detalhes sobre o formato.

S3CredentialRotationRequestStatus

S3CredentialRotationRequestStatus define o estado observado de um S3CredentialRotationRequest. Fornece feedback sobre o progresso e o resultado do processo de rotação de credenciais.

Aparece em: - S3CredentialRotationRequest

Campo Descrição
conditions Matriz de condições Conditions representa as observações disponíveis mais recentes do estado do pedido de rotação. Fornece uma análise detalhada do processo de rotação, incluindo a respetiva fase atual e quaisquer erros que possam ter ocorrido.
oldKeyRevocationTimestamp Hora OldKeyRevocationTimestamp é a data/hora em que a chave S3 antiga e rotativa vai ser permanentemente revogada do sistema de armazenamento de back-end. Este tempo é calculado adicionando o ExpirationDelay ao LastTransitionTime da condição RotationCompleted.

Etiqueta

Define as etiquetas no objeto que podem ser usadas pelo filtro de ciclo de vida.

Aparece em: - LifecycleRuleFilter

Campo Descrição
key string
value string