ProjectSource

Décrit la source du projet dans laquelle les objets correspondant aux filtres seront transformés.

Représentation JSON
{
  "project": string,
  "insightsDatasetConfig": string,
  "bucketFilters": {
    object (Expr)
  },
  "objectFilters": {
    object (Expr)
  },
  "dryRunJobId": string,
  "targetLocations": {
    object (TargetLocations)
  },
  "snapshotTime": string
}
Champs
project

string

Obligatoire. Nom de projet des objets à transformer, par exemple, projects/my-project ou projects/123456.

insightsDatasetConfig

string

Obligatoire. Identifiant de ressource de la configuration de l'ensemble de données Storage Insights. Les opérations par lot de stockage utilisent le dernier instantané de cet ensemble de données comme source pour lister et filtrer les objets cibles. Format: projects/{projectId}/locations/{location}/datasetConfigs/{dataset_config}.

bucketFilters

object (Expr)

Facultatif. Filtres exprimés en CEL (Common Expression Language) à appliquer aux buckets pour identifier ceux contenant des objets à transformer.

objectFilters

object (Expr)

Facultatif. Filtres exprimés en CEL (Common Expression Language) à appliquer aux objets pour identifier ceux à transformer.

dryRunJobId

string

Facultatif. Identifiant unique d'une tâche d'essai à utiliser comme référence pour la tâche actuelle.

La spécification de cet ID garantit que la tâche est exécutée sur le même ensemble d'objets validé lors du dry run. La valeur correspond au segment {jobId} du nom de la ressource : projects/{projectId}/locations/{location}/jobs/{jobId}.

targetLocations

object (TargetLocations)

Facultatif. Spécifie les emplacements Cloud Storage à inclure dans la tâche. Si cette option est fournie, seuls les buckets et les objets de ces emplacements seront découverts à partir de l'ensemble de données Storage Insights, tel qu'il est configuré dans insightsDatasetConfig. Si cette option est omise, la tâche découvrira les buckets et les objets de tous les emplacements configurés dans insightsDatasetConfig.

snapshotTime

string (Timestamp format)

Uniquement en sortie. Heure de l'instantané utilisée par la tâche pour lire l'ensemble de données Storage Insights afin de découvrir les buckets et les objets. Ce champ est renseigné par le service et reflète l'horodatage exact de l'instantané de l'ensemble de données utilisé.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Expr

Représente une expression textuelle dans la syntaxe CEL (Common Expression Language). CEL est un langage d'expression de type C. La syntaxe et la sémantique de CEL sont documentées à l'adresse https://github.com/google/cel-spec.

Exemple (comparaison) :

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

Exemple (égalité) :

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

Exemple (logique) :

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

Exemple (manipulation de données) :

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

Les fonctions et variables exactes pouvant être référencées dans une expression sont déterminées par le service qui l'évalue. Pour en savoir plus, consultez la documentation relative au service.

Représentation JSON
{
  "expression": string,
  "title": string,
  "description": string,
  "location": string
}
Champs
expression

string

Représentation textuelle d'une expression à l'aide de la syntaxe CEL (Common Expression Language).

title

string

Facultatif. Titre de l'expression, sous forme de chaîne courte décrivant son objectif. Il peut par exemple être utilisé dans les interfaces utilisateur qui permettent de saisir l'expression.

description

string

Facultatif. Description de l'expression. Il s'agit d'un texte plus long décrivant l'expression (par exemple, lorsque l'utilisateur passe la souris sur celle-ci dans une interface utilisateur).

location

string

Facultatif. Chaîne indiquant l'emplacement de l'expression pour la création de rapports d'erreurs (par exemple, un nom de fichier et une position dans le fichier).

TargetLocations

Décrit les emplacements Cloud Storage à inclure dans une tâche ProjectSource.

Représentation JSON
{
  "locations": [
    string
  ],
  "snapshotTime": string
}
Champs
locations[]

string

Obligatoire. Liste des emplacements Cloud Storage (par exemple, us-central1) à inclure dans la tâche.

Si snapshotTime est omis, la tâche utilise automatiquement l'horodatage de l'instantané le plus récent qui est correctement renseigné dans object_attributes_view et bucket_attributes_view pour tous les emplacements spécifiés.

Pour en savoir plus sur les instantanés et les vues d'ensemble de données Storage Insights, consultez la section Tables et schémas d'ensemble de données Storage Insights.

snapshotTime

string (Timestamp format)

Facultatif. Horodatage exact de l'instantané de l'ensemble de données Storage Insights à utiliser pour la tâche, compatible avec le format RFC 3339 (par exemple, 2024-01-02T03:04:05Z).

Si cette option est spécifiée, cet instantané exact doit exister dans object_attributes_view et bucket_attributes_view pour chaque emplacement listé dans locations. Si l'instantané est manquant dans l'une des vues de l'un des emplacements, la tâche échoue.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".