object.gdc.goog/v1
Contém definições de esquema de API para o grupo de APIs v1 do Object Storage.
Bucket
Define o esquema da 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 saber mais sobre os campos de metadata. |
spec BucketSpec |
|
status BucketStatus |
BucketInfo
Define o esquema da 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 saber mais sobre 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 saber mais sobre os campos de metadata. |
items Matriz de BucketInfo |
BucketInfoSpec
BucketInfoSpec define o estado desejado do recurso BucketInfo.
Aparece em: - BucketInfo
| Campo | Descrição |
|---|---|
description string |
A descrição do conteúdo do bucket. |
storageClass ObjectStorageClass |
Define a frequência com que os dados precisam ser acessados. As opções disponíveis incluem Standard e Nearline. O Standard é adequado para dados acessados com frequência, como sites, streaming de vídeos e apps para dispositivos móveis. É usado para dados que podem ser armazenados por pelo menos 30 dias. O Nearline é adequado para dados que podem ser armazenados por pelo menos 60 dias, incluindo backup de dados e conteúdo multimídia infrequente. |
bucketPolicy GlobalBucketPolicy |
Define políticas do recurso de bucket. Se não for especificado, as políticas padrão serão aplicadas. |
location string |
Define o local físico em que os dados do objeto no bucket estão armazenados. Se não for especificado, o padrão será o local em que o bucket está sendo criado. |
bucketName string |
O nome não namespaced do bucket provisionado. Isso é usado para se referir ao bucket ao usar ferramentas e bibliotecas locais. |
zonalEndpoints matriz de string |
Endpoints de DNS zonal em que o bucket pode ser acessado. Use esses endpoints se for necessário um failover personalizado. |
globalEndpoint string |
Endpoint global que vai rotear dinamicamente o tráfego para qualquer zona que contenha dados para esse bucket. Use esse endpoint se o failover automático for necessário. |
region string |
A região em que o bucket está armazenado. |
encryption EncryptionStatus |
O status da criptografia no bucket. |
allowDegradedWrites booleano |
Usado apenas para buckets síncronos. Determina se as operações do S3 precisam voltar à replicação assíncrona porque uma das zonas de replicação está indisponível. Isso evita que os buckets síncronos se tornem somente leitura caso uma das zonas de replicação fique inativa. Se estiver vazio, o padrão será "false". |
BucketInfoStatus
Define o estado observado do BucketInfo.
Aparece em: - BucketInfo
| Campo | Descrição |
|---|---|
conditions Matriz de condição |
BucketList
Contém uma lista de buckets.
| Campo | Descrição |
|---|---|
apiVersion string |
object.gdc.goog/v1 |
kind string |
BucketList |
metadata ListMeta |
Consulte a documentação da API Kubernetes para saber mais sobre os campos de metadata. |
items Matriz de bucket |
BucketPolicy
Define políticas do bucket.
Aparece em: - BucketSpec
| Campo | Descrição |
|---|---|
lockingPolicy LockingPolicy |
Política para bloqueio de objetos. Quando definida, o controle de versões de objetos é ativado, e todos os objetos armazenados no bucket ficam sujeitos a essa política. Um objeto bloqueado não pode ser excluído até que o bloqueio expire. Só pode ser ativada ao criar o bucket e não pode ser desativada depois. Quando não estão ativados, o bloqueio e o controle de versões de objetos ficam desativados e não podem ser ativados. |
corsPolicy CorsPolicy |
Política para conjunto de usuários de política de CORS personalizada definida no bucket. A CorsPolicy precisa ser ativada quando uma política de CORS adicional é necessária nos buckets. Caso contrário, o bucket terá apenas a política de CORS padrão do console da UI. A CorsPolicy pode ser adicionada ou modificada depois que o bucket é criado. |
lifecyclePolicy LifecyclePolicy |
Política para o conjunto de usuários da política de ciclo de vida personalizada no bucket. A LifecyclePolicy pode ser adicionada, modificada ou removida depois que o bucket é criado. |
BucketSpec
BucketSpec define o estado desejado do recurso Bucket.
Aparece em: - Bucket
| Campo | Descrição |
|---|---|
description string |
Descrição do conteúdo do bucket. |
storageClass ObjectStorageClass |
Define a frequência com que os dados precisam ser acessados. As opções disponíveis incluem Standard e Nearline. O Standard é adequado para dados acessados com frequência, como sites, streaming de vídeos e apps para dispositivos móveis. É usado para dados que podem ser armazenados por pelo menos 30 dias. O Nearline é adequado para dados que podem ser armazenados por pelo menos 60 dias, incluindo backup de dados e conteúdo multimídia infrequente. |
bucketPolicy BucketPolicy |
Define políticas do recurso de bucket. Se não for especificado, as políticas padrão serão aplicadas. |
location string |
Define o local físico em que os dados do objeto no bucket estão armazenados. Se não for especificado, o padrão será o local em que o bucket está sendo criado. |
BucketStatus
Define o estado observado do bucket.
Aparece em: - Bucket
| Campo | Descrição |
|---|---|
fullyQualifiedName string |
O nome do bucket provisionado. Esse nome é usado para se referir ao bucket ao usar ferramentas e bibliotecas externas. |
conditions Matriz de condição |
Especifica o status do bucket. As condições aceitas incluem BucketReady. Se BucketReady for True, isso indica que o bucket foi provisionado e está pronto para uso. |
endpoint string |
O endpoint DNS em que o bucket pode ser acessado. |
region string |
A região em que o bucket está armazenado. |
encryption EncryptionStatus |
O status da criptografia no bucket. |
errorStatus ErrorStatus |
ErrorStatus contém os erros mais recentes com os horários observados incluídos. |
CorsPolicy
Define a estratégia para configurar uma política de CORS personalizada no bucket.
Aparece em: - BucketPolicy - GlobalBucketPolicy
| Campo | Descrição |
|---|---|
enableCorsPolicy booleano |
Define se o usuário quer que a política personalizada entre em vigor no bucket. Se sim, a política personalizada definida em CorsDetail será lida. Caso contrário, CorsDetail não seria usado, mesmo que tivesse uma política personalizada configurada. |
corsDetail Matriz de CorsRule |
Detalhe da política de CORS personalizada que está sendo definida. |
CorsRule
Define as informações relacionadas à regra de CORS.
Aparece em: - CorsPolicy
| Campo | Descrição |
|---|---|
allowedHeaders matriz de string |
Cabeçalhos especificados no cabeçalho Access-Control-Request-Headers. |
allowedMethods matriz de string |
Métodos HTTP que podem ser executados por uma origem permitida. |
allowedOrigins matriz de string |
Origens que podem acessar o bucket. |
exposeHeaders matriz de string |
Cabeçalhos na resposta que podem ser acessados. |
id string |
Identificador exclusivo da regra. O valor não pode ter mais de 255 caracteres. |
EncryptionStatus
EncryptionStatus define o status da criptografia no bucket.
Aparece em: - BucketInfoSpec - BucketStatus
| Campo | Descrição |
|---|---|
type EncryptionType |
Define o tipo de criptografia a ser usado no bucket. As opções disponíveis são: - CMEK: chave de criptografia gerenciada pelo cliente que cria uma chave com suporte do KMS baseada no HSM pelo qual o cliente recebe cobranças. O cliente pode acessar e gerenciar essas chaves pelo KMS. |
keyRef ObjectReference |
"KeyRef" faz referência à chave usada como padrão para criptografar objetos no bucket. |
GlobalBucketPolicy
Define políticas do bucket.
Aparece em: - BucketInfoSpec
| Campo | Descrição |
|---|---|
lockingPolicy LockingPolicy |
Política para bloqueio de objetos. Quando definida, o controle de versões de objetos é ativado, e todos os objetos armazenados no bucket ficam sujeitos a essa política. Um objeto bloqueado não pode ser excluído até que o bloqueio expire. Só pode ser ativada ao criar o bucket e não pode ser desativada depois. |
corsPolicy CorsPolicy |
Política para conjunto de usuários de política de CORS personalizada definida no bucket. A CorsPolicy precisa ser ativada quando uma política de CORS adicional é necessária nos buckets. Caso contrário, o bucket terá apenas a política de CORS padrão do console da UI. A CorsPolicy pode ser adicionada ou modificada depois que o bucket é criado. |
lifecyclePolicy LifecyclePolicy |
Política para o conjunto de usuários da política de ciclo de vida personalizada no bucket. A LifecyclePolicy pode ser adicionada, modificada ou removida depois que o bucket é criado. |
LifecycleExpiration
Aparece em: - LifecycleRule
| Campo | Descrição |
|---|---|
date Tempo |
Data específica em que os objetos devem ser excluídos. |
days número inteiro |
Número de dias em que o objeto está sujeito à regra. |
LifecycleNoncurrentExpiration
Aparece em: - LifecycleRule
| Campo | Descrição |
|---|---|
noncurrentDays número inteiro |
Número de dias em que um objeto fica inativo antes que as regras de ciclo de vida realizem a ação. |
LifecyclePolicy
Aparece em: - BucketPolicy - GlobalBucketPolicy
| Campo | Descrição |
|---|---|
enable booleano |
Define se o usuário quer ativar uma política de ciclo de vida personalizada no bucket. |
lifecycleRules Matriz de LifecycleRule |
Consiste em uma ou mais regras de configuração de ciclo de vida que podem expirar objetos no bucket. |
LifecycleRule
Aparece em: - LifecyclePolicy
| Campo | Descrição |
|---|---|
id string |
Identificador exclusivo da regra. O valor não pode ter mais de 255 caracteres. |
status LifecycleRuleStatus |
Status da regra de ciclo de vida. Indique se essa regra realiza ações. O status pode ser alterado a qualquer momento, e apenas a regra ativada entra em vigor. |
expiration LifecycleExpiration |
Comportamento de expiração para objetos na versão atual. É necessário fornecer Expiration ou NoncurrentExpiration, ou ambos. Uma regra sem comportamento de expiração seria ignorada. |
noncurrentExpiration LifecycleNoncurrentExpiration |
Comportamento de expiração para objetos arquivados. |
filter LifecycleRuleFilter |
Filtre a regra. Um filtro vazio significa que a regra se aplica a todos os objetos no bucket. |
LifecycleRuleFilter
Define o filtro que pode ser definido na regra de ciclo de vida.
Aparece em: - LifecycleRule
| Campo | Descrição |
|---|---|
prefixFilter string |
Corresponde a objetos com o prefixo fornecido. Uma string de prefixo vazia significa que ela se aplica a todos os objetos no bucket. |
tagFilters matriz de tags |
Corresponde objetos com tags fornecidas. A tag no objeto precisa corresponder exatamente à chave e ao valor. |
LifecycleRuleStatus
Tipo subjacente:string
Aparece em: - LifecycleRule
LockingPolicy
Define a estratégia para bloquear os objetos do bucket.
Aparece em: - BucketPolicy - GlobalBucketPolicy
| Campo | Descrição |
|---|---|
defaultObjectRetentionDays número inteiro |
Especifica o número mínimo de dias que cada versão de cada objeto será retida. Não é possível excluir um objeto durante o período de armazenamento. Se um bucket tiver algum objeto, ele também não poderá ser excluído. Quando não especificado, nenhum período de armazenamento de objeto padrão é definido. Pode ser modificado após a criação, mas a mudança só vai entrar em vigor para novos objetos e versões. Os objetos e versões atuais ainda vão 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 saber mais sobre 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 saber mais sobre os campos de metadata. |
items S3CredentialRotationRequest |
S3CredentialRotationRequestSpec
S3CredentialRotationRequestSpec define o estado desejado de um S3CredentialRotationRequest. Essa especificação é usada para iniciar a rotação das credenciais do S3 armazenadas em um secret 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 precisam ser atualizadas. O Secret precisa estar no mesmo namespace que este S3CredentialRotationRequest. |
expirationDelay Duração |
ExpirationDelay especifica a duração em que a chave antiga e rotacionada do S3 vai permanecer válida depois que a nova chave for criada. Isso permite um período de transição gradual para que clientes e aplicativos mudem para as novas credenciais. Se não for especificado, um webhook de validação vai definir esse valor como 72 horas. Um valor de "0s" indica que a chave antiga deve ser revogada imediatamente após a ativação da nova. O formato é uma string de duração que pode ser analisada pela função time.ParseDuration do Go. Por exemplo, "72h", "90m", "30s". Unidades como "d" para dias não são aceitas. Consulte https://pkg.go.dev/time#ParseDuration para mais detalhes sobre o formato. |
requestTTL Duração |
RequestTTL define o tempo de vida (TTL) do próprio objeto S3CredentialRotationRequest. O timer de TTL começa depois que a rotação de credenciais é concluída (ou seja, quando a condição de status RotationCompleted se torna True). Após esse período, o objeto de solicitação será coletado automaticamente pelo sistema. Esse mecanismo preserva a solicitação como um registro de auditoria por um período configurável. Se não for especificado, um webhook de validação vai definir esse valor como 90 dias. O formato é uma string de duração que pode ser analisada pela função time.ParseDuration do Go. Por exemplo, "2160h" (para 90 dias), "72h", "30m". Unidades como "d" para dias não são aceitas. Consulte https://pkg.go.dev/time#ParseDuration para mais detalhes sobre o formato. |
S3CredentialRotationRequestStatus
S3CredentialRotationRequestStatus define o estado observado de um S3CredentialRotationRequest. Ele 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ção |
Condições representa as observações mais recentes disponíveis do estado da solicitação de rotação. Ele fornece um detalhamento do processo de rotação, incluindo a fase atual e os erros que podem ter ocorrido. |
oldKeyRevocationTimestamp Tempo |
OldKeyRevocationTimestamp é o carimbo de data/hora em que a chave antiga e alterada do S3 está programada para ser revogada permanentemente do sistema de armazenamento de back-end. Esse tempo é calculado adicionando o ExpirationDelay ao LastTransitionTime da condição RotationCompleted. |
Tag
Define as tags no objeto que podem ser usadas pelo filtro de ciclo de vida.
Aparece em: - LifecycleRuleFilter
| Campo | Descrição |
|---|---|
key string |
|
value string |