KRM API object.gdc.goog/v1

object.gdc.goog/v1

Contiene definiciones de esquemas de API para el grupo de APIs de Object Storage v1.

Segmento

Define el esquema de la API Buckets.

Aparece en: - BucketList

Campo Descripción
apiVersion string object.gdc.goog/v1
kind string Bucket
metadata ObjectMeta Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata.
spec BucketSpec
status BucketStatus

BucketInfo

Define el esquema de la API BucketInfo.

Aparece en: - BucketInfoList

Campo Descripción
apiVersion string object.gdc.goog/v1
kind string BucketInfo
metadata ObjectMeta Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata.
spec BucketInfoSpec
status BucketInfoStatus

BucketInfoList

Contiene una lista de BucketInfos.

Campo Descripción
apiVersion string object.gdc.goog/v1
kind string BucketInfoList
metadata ListMeta Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata.
items Matriz BucketInfo

BucketInfoSpec

BucketInfoSpec define el estado deseado del recurso BucketInfo.

Aparece en: - BucketInfo

Campo Descripción
description string Descripción del contenido del segmento.
storageClass ObjectStorageClass Define la frecuencia con la que se debe acceder a los datos. Entre las opciones disponibles se incluyen Standard y Nearline. Standard es adecuada para datos "calientes" a los que se accede con frecuencia, como sitios web, vídeos en streaming y aplicaciones móviles. Se usa para datos que se pueden almacenar durante al menos 30 días. Nearline es adecuada para datos que se puedan almacenar durante al menos 60 días, como copias de seguridad y contenido multimedia poco frecuente.
bucketPolicy GlobalBucketPolicy Define las políticas del recurso de segmento. Si no se especifica, se aplicarán las políticas predeterminadas.
location string Define el lugar físico donde se encuentran los datos de los objetos del segmento. Si no se especifica, se usará de forma predeterminada la ubicación en la que se está creando el segmento.
bucketName string Nombre sin espacio de nombres del segmento aprovisionado. Se usa para hacer referencia al segmento cuando se utilizan herramientas y bibliotecas locales.
zonalEndpoints array de cadena Endpoints de DNS de zona en los que se puede acceder al segmento. Usa estos endpoints si necesitas una conmutación por error personalizada.
globalEndpoint string Endpoint global que enrutará el tráfico de forma dinámica a cualquier zona que contenga datos de este segmento. Usa este endpoint si se requiere la conmutación por error automática.
region string La región donde se almacena el segmento.
encryption EncryptionStatus El estado del cifrado en el segmento.
allowDegradedWrites boolean Solo se usa para grupos síncronos. Determina si las operaciones de S3 deben volver a la replicación asíncrona debido a que una de las zonas de replicación no está disponible. De esta forma, se evita que los segmentos síncronos pasen a ser de solo lectura en caso de que una de las zonas de replicación no esté disponible. Si está vacío, el valor predeterminado es "false".

BucketInfoStatus

Define el estado observado de BucketInfo.

Aparece en: - BucketInfo

Campo Descripción
conditions Array Condition

BucketList

Contiene una lista de segmentos.

Campo Descripción
apiVersion string object.gdc.goog/v1
kind string BucketList
metadata ListMeta Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata.
items Matriz Bucket

BucketPolicy

Define las políticas del segmento.

Aparece en: - BucketSpec

Campo Descripción
lockingPolicy LockingPolicy Política de bloqueo de objetos. Si se define, se habilitará el control de versiones de objetos y todos los objetos almacenados en el segmento estarán sujetos a esta política. Un objeto bloqueado no se puede eliminar hasta que caduque el bloqueo. Solo se puede habilitar al crear el segmento y no se puede inhabilitar después. Si no se habilita, el bloqueo de objetos y la gestión de versiones se inhabilitarán y no se podrán habilitar.
corsPolicy CorsPolicy Política para el usuario de la política de CORS personalizada definida en el segmento. CorsPolicy debe estar habilitada cuando se necesite una política de CORS adicional en los segmentos. De lo contrario, el segmento solo tendrá la política de CORS predeterminada de la consola de la interfaz de usuario. CorsPolicy siempre se puede añadir o modificar después de crear el segmento.
lifecyclePolicy LifecyclePolicy Política para el conjunto de usuarios de la política de ciclo de vida personalizada definida en el segmento. LifecyclePolicy siempre se puede añadir, modificar o eliminar después de crear el segmento.

BucketSpec

BucketSpec define el estado deseado del recurso de segmento.

Aparece en: - Segmento

Campo Descripción
description string Descripción del contenido del segmento.
storageClass ObjectStorageClass Define la frecuencia con la que se debe acceder a los datos. Entre las opciones disponibles se incluyen Standard y Nearline. Standard es adecuada para datos "calientes" a los que se accede con frecuencia, como sitios web, vídeos en streaming y aplicaciones móviles. Se usa para datos que se pueden almacenar durante al menos 30 días. Nearline es adecuada para datos que se puedan almacenar durante al menos 60 días, como copias de seguridad y contenido multimedia poco frecuente.
bucketPolicy BucketPolicy Define las políticas del recurso de segmento. Si no se especifica, se aplicarán las políticas predeterminadas.
location string Define el lugar físico donde se encuentran los datos de los objetos del segmento. Si no se especifica, se usará de forma predeterminada la ubicación en la que se está creando el segmento.

BucketStatus

Define el estado observado del segmento.

Aparece en: - Segmento

Campo Descripción
fullyQualifiedName string El nombre del segmento aprovisionado. Este nombre se usa para hacer referencia al segmento cuando se utilizan herramientas y bibliotecas externas.
conditions Array Condition Especifica el estado del segmento. Entre las condiciones admitidas se incluyen BucketReady. Si BucketReady es True, significa que el segmento se ha aprovisionado y está listo para usarse.
endpoint string El endpoint de DNS al que se puede acceder desde el segmento.
region string La región donde se almacena el segmento.
encryption EncryptionStatus El estado del cifrado en el segmento.
errorStatus ErrorStatus ErrorStatus contiene los errores más recientes, incluidos los momentos en que se han observado.

CorsPolicy

Define la estrategia para configurar una política de CORS personalizada en el segmento.

Aparece en: - BucketPolicy - GlobalBucketPolicy

Campo Descripción
enableCorsPolicy boolean Define si el usuario quiere que la política personalizada se aplique al segmento. Si es así, se leerá la política personalizada definida en CorsDetail. De lo contrario, CorsDetail no se usará aunque tenga configurada una política personalizada.
corsDetail Array CorsRule Detalle de la política de CORS personalizada que se está definiendo.

CorsRule

Define la información relacionada con la regla de CORS.

Aparece en: - CorsPolicy

Campo Descripción
allowedHeaders array de cadena Encabezados que se especifican en el encabezado Access-Control-Request-Headers.
allowedMethods array de cadena Métodos HTTP que se pueden ejecutar desde un origen permitido.
allowedOrigins array de cadena Orígenes que pueden acceder al segmento.
exposeHeaders array de cadena Encabezados de la respuesta a los que se puede acceder.
id string Identificador único de la regla. El valor no puede tener más de 255 caracteres.

EncryptionStatus

EncryptionStatus define el estado del cifrado en el segmento.

Aparece en: - BucketInfoSpec - BucketStatus

Campo Descripción
type EncryptionType Define el tipo de cifrado que se usará en el segmento. Las opciones disponibles son: - CMEK: clave de cifrado gestionada por el cliente que crea una clave respaldada por KMS con origen en el HSM por la que se factura al cliente. El cliente puede acceder a estas claves y gestionarlas a través de KMS.
keyRef ObjectReference KeyRef hace referencia a la clave que se usa como clave predeterminada para cifrar objetos del segmento.

GlobalBucketPolicy

Define las políticas del segmento.

Aparece en: - BucketInfoSpec

Campo Descripción
lockingPolicy LockingPolicy Política de bloqueo de objetos. Si se define, se habilitará el control de versiones de objetos y todos los objetos almacenados en el segmento estarán sujetos a esta política. Un objeto bloqueado no se puede eliminar hasta que caduque el bloqueo. Solo se puede habilitar al crear el segmento y no se puede inhabilitar después.
corsPolicy CorsPolicy Política para el usuario de la política de CORS personalizada definida en el segmento. CorsPolicy debe estar habilitada cuando se necesite una política de CORS adicional en los segmentos. De lo contrario, el segmento solo tendrá la política de CORS predeterminada de la consola de la interfaz de usuario. CorsPolicy siempre se puede añadir o modificar después de crear el segmento.
lifecyclePolicy LifecyclePolicy Política para el conjunto de usuarios de la política de ciclo de vida personalizada definida en el segmento. LifecyclePolicy siempre se puede añadir, modificar o eliminar después de crear el segmento.

LifecycleExpiration

Aparece en: - LifecycleRule

Campo Descripción
date Hora Fecha específica en la que se deben eliminar los objetos.
days número entero Número de días que este objeto está sujeto a la regla.

LifecycleNoncurrentExpiration

Aparece en: - LifecycleRule

Campo Descripción
noncurrentDays número entero Número de días que un objeto no está actualizado antes de que las reglas de ciclo de vida realicen la acción.

LifecyclePolicy

Aparece en: - BucketPolicy - GlobalBucketPolicy

Campo Descripción
enable boolean Define si el usuario quiere habilitar una política de ciclo de vida personalizada en el segmento.
lifecycleRules Matriz LifecycleRule Consta de una o varias reglas de configuración del ciclo de vida que pueden realizar acciones de vencimiento en los objetos del segmento.

LifecycleRule

Aparece en: - LifecyclePolicy

Campo Descripción
id string Identificador único de la regla. El valor no puede tener más de 255 caracteres.
status LifecycleRuleStatus Estado de la regla de ciclo de vida. Indica si esta regla pasa a la acción. El estado se puede cambiar en cualquier momento, y solo se aplicarán las reglas habilitadas.
expiration LifecycleExpiration Comportamiento de vencimiento de los objetos de la versión actual. Se debe proporcionar Expiration o NoncurrentExpiration, o ambos. La regla sin comportamiento de vencimiento se ignorará.
noncurrentExpiration LifecycleNoncurrentExpiration Comportamiento de vencimiento de los objetos no actuales.
filter LifecycleRuleFilter Filtrar por la regla. Si el filtro está vacío, la regla se aplicará a todos los objetos del segmento.

LifecycleRuleFilter

Define el filtro que se puede definir en la regla de ciclo de vida.

Aparece en: - LifecycleRule

Campo Descripción
prefixFilter string Busca objetos con el prefijo proporcionado. Si la cadena de prefijo está vacía, se aplicará a todos los objetos del segmento.
tagFilters Matriz de etiquetas Relaciona objetos con las etiquetas proporcionadas. La etiqueta del objeto debe coincidir exactamente con la clave y el valor.

LifecycleRuleStatus

Tipo subyacente: string

Aparece en: - LifecycleRule

LockingPolicy

Define la estrategia para bloquear los objetos del segmento.

Aparece en: - BucketPolicy - GlobalBucketPolicy

Campo Descripción
defaultObjectRetentionDays número entero Especifica el número mínimo de días que se conservará cada versión de cada objeto. No se puede eliminar un objeto durante el periodo de conservación. Si un segmento contiene algún objeto, tampoco se puede eliminar. Si no se especifica, no se define ningún periodo de conservación de objetos predeterminado. Se puede modificar después de la creación, pero el cambio solo se aplicará a los objetos y las versiones nuevos. Los objetos y las versiones que ya existan seguirán usando el valor anterior.

S3CredentialRotationRequest

S3CredentialRotationRequest es el esquema de la API S3CredentialRotationRequests

Aparece en: - S3CredentialRotationRequestList

Campo Descripción
apiVersion string object.gdc.goog/v1
kind string S3CredentialRotationRequest
metadata ObjectMeta Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata.
spec S3CredentialRotationRequestSpec
status S3CredentialRotationRequestStatus

S3CredentialRotationRequestList

S3CredentialRotationRequestList contiene una lista de S3CredentialRotationRequest

Campo Descripción
apiVersion string object.gdc.goog/v1
kind string S3CredentialRotationRequestList
metadata ListMeta Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata.
items Array S3CredentialRotationRequest

S3CredentialRotationRequestSpec

S3CredentialRotationRequestSpec define el estado deseado de una solicitud S3CredentialRotationRequest. Esta especificación se usa para iniciar la rotación de las credenciales de S3 almacenadas en un secreto de Kubernetes.

Aparece en: - S3CredentialRotationRequest

Campo Descripción
secretName string SecretName es el nombre del secreto de Kubernetes que contiene las credenciales de S3 que se deben rotar. El Secret debe existir en el mismo espacio de nombres que este S3CredentialRotationRequest.
expirationDelay Duración ExpirationDelay especifica la duración durante la cual la clave S3 antigua y rotada seguirá siendo válida después de que se haya creado la nueva clave. De esta forma, los clientes y las aplicaciones disponen de un periodo de transición para cambiar a las nuevas credenciales. Si no se especifica, un webhook predeterminado asignará a este valor 72 horas. El valor "0s" indica que la clave antigua se debe revocar inmediatamente después de activar la nueva. El formato es una cadena de duración que se puede analizar con la función time.ParseDuration de Go. Por ejemplo, "72h", "90m" o "30s". Ten en cuenta que no se admiten unidades como "d" para los días. Consulta https://pkg.go.dev/time#ParseDuration para obtener más información sobre el formato.
requestTTL Duración RequestTTL define el tiempo de vida (TTL) de este objeto S3CredentialRotationRequest. El temporizador de TTL se inicia una vez que se completa la rotación de credenciales (es decir, cuando la condición de estado RotationCompleted pasa a ser True). Una vez transcurrido este tiempo, el sistema recogerá automáticamente el objeto de solicitud. Este mecanismo conserva la solicitud como un registro de auditoría durante un periodo configurable. Si no se especifica, un webhook predeterminado asignará a este valor un periodo de 90 días. El formato es una cadena de duración que se puede analizar con la función time.ParseDuration de Go. Por ejemplo, "2160h" (para 90 días), "72h" o "30m". Ten en cuenta que no se admiten unidades como "d" para los días. Consulta https://pkg.go.dev/time#ParseDuration para obtener más información sobre el formato.

S3CredentialRotationRequestStatus

S3CredentialRotationRequestStatus define el estado observado de una S3CredentialRotationRequest. Ofrece información sobre el progreso y el resultado del proceso de rotación de credenciales.

Aparece en: - S3CredentialRotationRequest

Campo Descripción
conditions Array Condition Las condiciones representan las últimas observaciones disponibles del estado de la solicitud de rotación. Proporciona un desglose detallado del proceso de rotación, incluida la fase actual y los errores que se hayan producido.
oldKeyRevocationTimestamp Hora OldKeyRevocationTimestamp es la marca de tiempo en la que se ha programado que la clave S3 antigua y rotada se revoque de forma permanente del sistema de almacenamiento backend. Este tiempo se calcula sumando ExpirationDelay a LastTransitionTime de la condición RotationCompleted.

Etiqueta

Define las etiquetas del objeto que puede usar el filtro de ciclo de vida.

Aparece en: - LifecycleRuleFilter

Campo Descripción
key string
value string