object.gdc.goog/v1
Contiene definiciones de esquemas de API para el grupo de APIs Object Storage v1.
Segmento
Define el esquema de la API Buckets.
Aparece en: - BucketList
| Campo | Descripción |
|---|---|
apiVersion cadena |
object.gdc.goog/v1 |
kind cadena |
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 cadena |
object.gdc.goog/v1 |
kind cadena |
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 cadena |
object.gdc.goog/v1 |
kind cadena |
BucketInfoList |
metadata ListMeta |
Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata. |
items BucketInfo |
BucketInfoSpec
BucketInfoSpec define el estado deseado del recurso BucketInfo.
Aparece en: - BucketInfo
| Campo | Descripción |
|---|---|
description cadena |
Descripción del contenido del segmento. |
storageClass ObjectStorageClass |
Define la frecuencia con la que se debe acceder a los datos. Las opciones disponibles son Standard y Nearline. Standard es adecuada para datos activos a los que se accede con frecuencia, como los de 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 contenedor. Si no se especifica, se aplican las políticas predeterminadas. |
location cadena |
Define el lugar físico donde residen los datos de los objetos del segmento. Si no se especifica, se usará la ubicación en la que se está creando el bucket. |
bucketName cadena |
Nombre del segmento aprovisionado sin espacio de nombres. Se usa para hacer referencia al segmento al usar herramientas y bibliotecas locales. |
zonalEndpoints matriz de cadenas |
Endpoints de DNS zonales en los que se puede acceder al bucket. Usa estos endpoints si necesitas una conmutación por error personalizada. |
globalEndpoint cadena |
Endpoint global que enrutará dinámicamente el tráfico a cualquier zona que contenga datos de este segmento. Usa este endpoint si es necesario aplicar una conmutación por error automática. |
region cadena |
La región en la que se almacena el segmento. |
encryption EncryptionStatus |
Estado del cifrado del contenedor. |
allowDegradedWrites booleano |
Solo se usa en los segmentos 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 contenedores síncronos pasen a ser de solo lectura en caso de que una de las zonas de replicación no funcione. Si está vacío, el valor predeterminado es false. |
BucketInfoStatus
Define el estado observado de BucketInfo.
Aparece en: - BucketInfo
| Campo | Descripción |
|---|---|
conditions Matriz Condition |
BucketList
Contiene una lista de contenedores.
| Campo | Descripción |
|---|---|
apiVersion cadena |
object.gdc.goog/v1 |
kind cadena |
BucketList |
metadata ListMeta |
Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata. |
items Matriz de categorías |
BucketPolicy
Define las políticas del cubo.
Aparece en: - BucketSpec
| Campo | Descripción |
|---|---|
lockingPolicy LockingPolicy |
Política de bloqueo de objetos. Si se define, la gestión de versiones de objetos se habilita y todos los objetos almacenados en el segmento estarán sujetos a esta política. No se puede eliminar un objeto bloqueado hasta que caduque el bloqueo. Solo se puede habilitar al crear el segmento y no se puede inhabilitar después. Si no está habilitada, el bloqueo y la gestión de versiones de objetos están inhabilitados y no se pueden habilitar. |
corsPolicy CorsPolicy |
Política de CORS personalizada definida por el usuario en el segmento. CorsPolicy debe habilitarse cuando se necesite una política de CORS adicional en los contenedores. 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 más adelante, después de crear el segmento. |
lifecyclePolicy LifecyclePolicy |
Política de ciclo de vida personalizada definida para el conjunto de usuarios de la política en el cubo. LifecyclePolicy se puede añadir, modificar o eliminar en cualquier momento después de crear el bucket. |
BucketSpec
BucketSpec define el estado deseado del recurso de segmento.
Aparece en: - Segmento
| Campo | Descripción |
|---|---|
description cadena |
Descripción del contenido del segmento. |
storageClass ObjectStorageClass |
Define la frecuencia con la que se debe acceder a los datos. Las opciones disponibles son Standard y Nearline. Standard es adecuada para datos activos a los que se accede con frecuencia, como los de 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 contenedor. Si no se especifica, se aplican las políticas predeterminadas. |
location cadena |
Define el lugar físico donde residen los datos de los objetos del segmento. Si no se especifica, se usará la ubicación en la que se está creando el bucket. |
BucketStatus
Define el estado observado del elemento Bucket.
Aparece en: - Segmento
| Campo | Descripción |
|---|---|
fullyQualifiedName cadena |
Nombre del segmento aprovisionado. Este nombre se usa para hacer referencia al segmento cuando se utilizan herramientas y bibliotecas externas. |
conditions Matriz 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 cadena |
El endpoint de DNS en el que se puede acceder al segmento. |
region cadena |
La región en la que se almacena el segmento. |
encryption EncryptionStatus |
Estado del cifrado del contenedor. |
errorStatus ErrorStatus |
ErrorStatus contiene los errores más recientes con las horas observadas incluidas. |
CorsPolicy
Define la estrategia para configurar una política de CORS personalizada en el segmento.
Aparece en: - BucketPolicy - GlobalBucketPolicy
| Campo | Descripción |
|---|---|
enableCorsPolicy booleano |
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ía aunque tuviera una política personalizada configurada. |
corsDetail Matriz CorsRule |
Detalles de la política de CORS personalizada que se está definiendo. |
CorsRule
Define la información relacionada con la regla CORS.
Aparece en: - CorsPolicy
| Campo | Descripción |
|---|---|
allowedHeaders matriz de cadenas |
Encabezados especificados en el encabezado Access-Control-Request-Headers. |
allowedMethods matriz de cadenas |
Métodos HTTP que puede ejecutar un origen permitido. |
allowedOrigins matriz de cadenas |
Orígenes que pueden acceder al segmento. |
exposeHeaders matriz de cadenas |
Encabezados de la respuesta a los que se puede acceder. |
id cadena |
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 va a usar en el contenedor. Las opciones disponibles son las siguientes: - CMEK: clave de cifrado gestionada por el cliente, que crea una clave respaldada por KMS y basada 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 en el segmento. |
GlobalBucketPolicy
Define las políticas del cubo.
Aparece en: - BucketInfoSpec
| Campo | Descripción |
|---|---|
lockingPolicy LockingPolicy |
Política de bloqueo de objetos. Si se define, la gestión de versiones de objetos se habilita y todos los objetos almacenados en el segmento estarán sujetos a esta política. No se puede eliminar un objeto bloqueado hasta que caduque el bloqueo. Solo se puede habilitar al crear el segmento y no se puede inhabilitar después. |
corsPolicy CorsPolicy |
Política de CORS personalizada definida por el usuario en el segmento. CorsPolicy debe habilitarse cuando se necesite una política de CORS adicional en los contenedores. 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 más adelante, después de crear el segmento. |
lifecyclePolicy LifecyclePolicy |
Política de ciclo de vida personalizada definida para el conjunto de usuarios de la política en el cubo. LifecyclePolicy se puede añadir, modificar o eliminar en cualquier momento después de crear el bucket. |
LifecycleExpiration
Aparece en: - LifecycleRule
| Campo | Descripción |
|---|---|
date Hora |
Fecha específica en la que se deben eliminar los objetos. |
days entero |
Número de días que este objeto está sujeto a la regla. |
LifecycleNoncurrentExpiration
Aparece en: - LifecycleRule
| Campo | Descripción |
|---|---|
noncurrentDays entero |
Número de días que un objeto no está en la versión actual antes de que las reglas de ciclo de vida realicen la acción. |
LifecyclePolicy
Aparece en: - BucketPolicy - GlobalBucketPolicy
| Campo | Descripción |
|---|---|
enable booleano |
Define si el usuario quiere habilitar una política de ciclo de vida personalizada en el bucket. |
lifecycleRules Matriz LifecycleRule |
Consta de una o varias reglas de configuración del ciclo de vida que pueden caducar los objetos del segmento. |
LifecycleRule
Aparece en: - LifecyclePolicy
| Campo | Descripción |
|---|---|
id cadena |
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 toma medidas. El estado se puede cambiar en cualquier momento y solo las reglas habilitadas tendrán efecto. |
expiration LifecycleExpiration |
Comportamiento de caducidad de los objetos de la versión actual. Se debe proporcionar Expiration o NoncurrentExpiration, o ambos. La regla sin comportamiento de vencimiento se ignoraría. |
noncurrentExpiration LifecycleNoncurrentExpiration |
Comportamiento de vencimiento de objetos que no están al día. |
filter LifecycleRuleFilter |
Filtra la regla. Si el filtro está vacío, la regla se aplica 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 cadena |
Coincide con los objetos que tengan el prefijo proporcionado. Si el prefijo es una cadena vacía, se aplica a todos los objetos del segmento. |
tagFilters Matriz de etiquetas |
Coincide con los objetos que tengan 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 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 retención. Si un contenedor contiene algún objeto, tampoco se puede eliminar. Si no se especifica, no se define ningún periodo de retenció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 cadena |
object.gdc.goog/v1 |
kind cadena |
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 cadena |
object.gdc.goog/v1 |
kind cadena |
S3CredentialRotationRequestList |
metadata ListMeta |
Consulta la documentación sobre la API de Kubernetes para ver los campos de metadata. |
items Matriz S3CredentialRotationRequest |
S3CredentialRotationRequestSpec
S3CredentialRotationRequestSpec define el estado deseado de un 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 cadena |
SecretName es el nombre del secreto de Kubernetes que contiene las credenciales de S3 que se deben rotar. El secreto debe estar en el mismo espacio de nombres que este S3CredentialRotationRequest. |
expirationDelay Duración |
ExpirationDelay especifica la duración durante la cual la clave de 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 dispondrán de un periodo de transición para cambiar a las nuevas credenciales. Si no se especifica, un webhook predeterminado asigna a este valor el plazo de 72 horas. El valor "0s" indica que la clave antigua debe revocarse inmediatamente después de activar la nueva. El formato es una cadena de duración que puede analizar la función time.ParseDuration de Go. Por ejemplo, "72h", "90m" o "30s". Ten en cuenta que no se admiten unidades como "d" para 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 TTL empieza a contar cuando se completa la rotación de credenciales (es decir, cuando la condición de estado RotationCompleted pasa a ser True). Después de este periodo, el sistema eliminará automáticamente el objeto de solicitud. Este mecanismo conserva la solicitud como registro de auditoría durante un periodo configurable. Si no se especifica, un webhook predeterminado asigna a este valor el valor predeterminado de 90 días. El formato es una cadena de duración que puede analizar la función time.ParseDuration de Go. Por ejemplo, "2160h" (90 días), "72h" o "30m". Ten en cuenta que no se admiten unidades como "d" para 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 un S3CredentialRotationRequest. Proporciona comentarios sobre el progreso y el resultado del proceso de rotación de credenciales.
Aparece en: - S3CredentialRotationRequest
| Campo | Descripción |
|---|---|
conditions Matriz Condition |
Conditions representa las últimas observaciones disponibles del estado de la solicitud de rotación. Proporciona un desglose detallado del proceso de rotación, incluida su fase actual y los errores que se hayan podido producir. |
oldKeyRevocationTimestamp Hora |
OldKeyRevocationTimestamp es la marca de tiempo en la que se va a revocar de forma permanente la clave de S3 antigua y rotada del sistema de almacenamiento backend. Este tiempo se calcula sumando ExpirationDelay a LastTransitionTime de la condición RotationCompleted. |
Etiqueta
Define las etiquetas de los objetos que se pueden usar en el filtro de ciclo de vida.
Aparece en: - LifecycleRuleFilter
| Campo | Descripción |
|---|---|
key cadena |
|
value cadena |