ProjectSource

Describe el origen del proyecto en el que se transformarán los objetos que satisfagan los filtros.

Representación JSON
{
  "project": string,
  "insightsDatasetConfig": string,
  "bucketFilters": {
    object (Expr)
  },
  "objectFilters": {
    object (Expr)
  },
  "dryRunJobId": string,
  "targetLocations": {
    object (TargetLocations)
  },
  "snapshotTime": string
}
Campos
project

string

Obligatorio. Nombre del proyecto de los objetos que se transformarán, por ejemplo, projects/my-project o projects/123456.

insightsDatasetConfig

string

Obligatorio. Es el identificador de recursos de la configuración del conjunto de datos de Storage Insights. Las operaciones por lotes de Storage usan la instantánea más reciente de este conjunto de datos como origen para enumerar y filtrar los objetos de destino. Formato: projects/{projectId}/locations/{location}/datasetConfigs/{dataset_config}.

bucketFilters

object (Expr)

Es opcional. Son filtros expresados en Common Expression Language (CEL) que se aplican a los buckets para identificar aquellos con objetos que se transformarán.

objectFilters

object (Expr)

Es opcional. Son filtros expresados en Common Expression Language (CEL) que se aplican a los objetos para identificar aquellos que se transformarán.

dryRunJobId

string

Es opcional. Es el identificador único de un trabajo de prueba que se usará como línea de base para el trabajo actual.

Si se especifica este ID, se garantiza que el trabajo se ejecute en el mismo conjunto de objetos validados durante la ejecución de prueba. El valor corresponde al segmento {jobId} del nombre del recurso: projects/{projectId}/locations/{location}/jobs/{jobId}.

targetLocations

object (TargetLocations)

Es opcional. Especifica las ubicaciones de Cloud Storage que se incluirán en el trabajo. Si se proporciona, solo se descubrirán los buckets y los objetos dentro de estas ubicaciones del conjunto de datos de Storage Insights, según se configuró en insightsDatasetConfig. Si se omite, el trabajo descubrirá buckets y objetos de todas las ubicaciones configuradas en insightsDatasetConfig.

snapshotTime

string (Timestamp format)

Solo salida. Es la hora de la instantánea que usa el trabajo para leer el conjunto de datos de Storage Insights para el descubrimiento de bucket y objetos. El servicio propaga este campo y refleja la marca de tiempo exacta de la instantánea del conjunto de datos que se usó.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Expr

Representa una expresión textual en la sintaxis de Common Expression Language (CEL). CEL es un lenguaje de expresión similar a C. La sintaxis y la semántica de CEL se documentan en https://github.com/google/cel-spec.

Ejemplo (comparación):

title: "Summary size limit"
description: "Determines if a summary is less than 100 chars"
expression: "document.summary.size() < 100"

Ejemplo (igualdad):

title: "Requestor is owner"
description: "Determines if requestor is the document owner"
expression: "document.owner == request.auth.claims.email"

Ejemplo (lógica):

title: "Public documents"
description: "Determine whether the document should be publicly visible"
expression: "document.type != 'private' && document.type != 'internal'"

Ejemplo (manipulación de datos):

title: "Notification string"
description: "Create a notification string with a timestamp."
expression: "'New message received at ' + string(document.create_time)"

El servicio que evalúa la expresión determina las variables y las funciones exactas a las que se puede hacer referencia en la expresión. Para obtener más información, consulta la documentación del servicio.

Representación JSON
{
  "expression": string,
  "title": string,
  "description": string,
  "location": string
}
Campos
expression

string

Representación textual de una expresión en la sintaxis de Common Expression Language.

title

string

Opcional. Título de la expresión (una string corta que describe el propósito de esta). Se puede usar, p. ej., en IU que permiten ingresar la expresión.

description

string

Opcional. Descripción de la expresión. Es un texto más largo que describe la expresión (p. ej., cuando se coloca el cursor sobre ella en una IU).

location

string

Es opcional. Una cadena que indica la ubicación de la expresión para los informes de errores (p.ej., un nombre de archivo y una posición en este).

TargetLocations

Describe las ubicaciones de Cloud Storage que se incluirán en un trabajo de ProjectSource.

Representación JSON
{
  "locations": [
    string
  ],
  "snapshotTime": string
}
Campos
locations[]

string

Obligatorio. Es una lista de ubicaciones de Cloud Storage (por ejemplo, us-central1) que se incluirán en el trabajo.

Si se omite snapshotTime, el trabajo se establece automáticamente en la marca de tiempo de la instantánea más reciente que se propaga correctamente en object_attributes_view y bucket_attributes_view en todas las ubicaciones especificadas.

Para obtener detalles sobre las instantáneas y las vistas del conjunto de datos de Storage Insights, consulta Tablas y esquemas del conjunto de datos de Storage Insights.

snapshotTime

string (Timestamp format)

Es opcional. Es la marca de tiempo exacta de la instantánea del conjunto de datos de Storage Insights que se usará para el trabajo compatible con el formato RFC 3339 (por ejemplo, 2024-01-02T03:04:05Z).

Si se especifica, esta instantánea exacta debe existir en object_attributes_view y bucket_attributes_view para cada ubicación que aparece en locations. Si falta la instantánea en alguna de las vistas en cualquiera de las ubicaciones, el trabajo falla.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".