REST Resource: projects.locations.datasetConfigs

Risorsa: DatasetConfig

Messaggio che descrive le proprietà di configurazione del set di dati. Per ulteriori informazioni, consulta Proprietà di configurazione del set di dati.

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "uid": string,
  "organizationNumber": string,
  "includeNewlyCreatedBuckets": boolean,
  "retentionPeriodDays": integer,
  "link": {
    object (Link)
  },
  "identity": {
    object (Identity)
  },
  "status": {
    object (Status)
  },
  "datasetConfigState": enum (ConfigState),
  "description": string,

  // Union field source_options can be only one of the following:
  "sourceProjects": {
    object (SourceProjects)
  },
  "sourceFolders": {
    object (SourceFolders)
  },
  "organizationScope": boolean,
  "cloudStorageObjectPath": string
  // End of list of possible types for union field source_options.

  // Union field cloud_storage_locations can be only one of the following:
  "includeCloudStorageLocations": {
    object (CloudStorageLocations)
  },
  "excludeCloudStorageLocations": {
    object (CloudStorageLocations)
  }
  // End of list of possible types for union field cloud_storage_locations.

  // Union field cloud_storage_buckets can be only one of the following:
  "includeCloudStorageBuckets": {
    object (CloudStorageBuckets)
  },
  "excludeCloudStorageBuckets": {
    object (CloudStorageBuckets)
  }
  // End of list of possible types for union field cloud_storage_buckets.
}
Campi
name

string

Identificatore. Nome della risorsa
createTime

string (Timestamp format)

Solo output. L'ora UTC in cui è stata creata la configurazione del set di dati. Questo campo viene compilato automaticamente.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora UTC dell'ultimo aggiornamento della configurazione del set di dati. Questo campo viene compilato automaticamente.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Etichette come coppie chiave-valore

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Solo output. Identificatore univoco generato dal sistema per la risorsa.
organizationNumber

string (int64 format)

Facoltativo. L'ID risorsa dell'organizzazione a cui devono appartenere i progetti di origine. I progetti che non appartengono all'organizzazione fornita non vengono presi in considerazione durante la creazione del set di dati.
includeNewlyCreatedBuckets

boolean

Se impostato su true, la richiesta include tutti i bucket appena creati nel set di dati che soddisfano le regole di inclusione ed esclusione.
retentionPeriodDays

integer

Numero di giorni di cronologia da conservare.
identity

object (Identity)

Identità utilizzata da questo datasetConfig.
status

object (Status)

Solo output. Stato di datasetConfig.
datasetConfigState

enum (ConfigState)

Solo output. Stato del datasetConfig.
description

string

Facoltativo. Una descrizione fornita dall'utente per la configurazione del set di dati.

Lunghezza massima: 256 caratteri.
Campo unione source_options. Definisce le opzioni per fornire gli identificatori di origine per il set di dati. source_options può essere solo uno dei seguenti:
sourceProjects

object (SourceProjects)

Definisce le opzioni per fornire i progetti di origine per il set di dati.
sourceFolders

object (SourceFolders)

Definisce le opzioni per fornire le cartelle di origine per il set di dati.
organizationScope

boolean

Definisce le opzioni per fornire un'organizzazione di origine per il set di dati.
cloudStorageObjectPath

string

Solo input. Percorso dell'oggetto Cloud Storage contenente un elenco di numeri di progetti o cartelle da includere nel set di dati. Non può contenere una combinazione di progetti e cartelle.

L'oggetto deve essere un file di testo in cui ogni riga contiene una delle seguenti voci:

  • Numero progetto, formattato come projects/{projectNumber}, ad esempio projects/1234567890.
  • Identificatore della cartella, formattato come folders/{folder_number}, ad esempio folders/9876543210. Il percorso deve essere nel formato gs://{bucketName}/{objectName}.
Campo unione cloud_storage_locations. Località Cloud Storage da includere o escludere. cloud_storage_locations può essere solo uno dei seguenti:
includeCloudStorageLocations

object (CloudStorageLocations)
excludeCloudStorageLocations

object (CloudStorageLocations)
Campo unione cloud_storage_buckets. I bucket Cloud Storage da includere o escludere. cloud_storage_buckets può essere solo uno dei seguenti:
includeCloudStorageBuckets

object (CloudStorageBuckets)
excludeCloudStorageBuckets

object (CloudStorageBuckets)

SourceProjects

Raccolta di numeri di progetto

Rappresentazione JSON 
{
  "projectNumbers": [
    string
  ]
}
Campi
projectNumbers[]

string (int64 format)

SourceFolders

Specifica un insieme di cartelle da includere nel set di dati

Rappresentazione JSON 
{
  "folderNumbers": [
    string
  ]
}
Campi
folderNumbers[]

string (int64 format)

Facoltativo. L'elenco dei numeri di cartelle da includere nel set di dati.

CloudStorageLocations

Raccolta di località Cloud Storage.

Rappresentazione JSON 
{
  "locations": [
    string
  ]
}
Campi
locations[]

string

CloudStorageBuckets

Raccolta di bucket Cloud Storage.

Rappresentazione JSON 
{
  "cloudStorageBuckets": [
    {
      object (CloudStorageBucket)
    }
  ]
}
Campi
cloudStorageBuckets[]

object (CloudStorageBucket)

CloudStorageBucket

Definisce il bucket in base al nome o a un pattern regex per trovare corrispondenze tra i bucket.

Rappresentazione JSON 
{

  // Union field cloud_storage_bucket can be only one of the following:
  "bucketName": string,
  "bucketPrefixRegex": string
  // End of list of possible types for union field cloud_storage_bucket.
}
Campi

Campo unione cloud_storage_bucket.

cloud_storage_bucket può essere solo uno dei seguenti:
bucketName

string

Nome del bucket Cloud Storage.
bucketPrefixRegex

string

Un pattern regex per i nomi dei bucket corrispondenti alla regex. La regex deve seguire la sintassi specificata in google/re2 su GitHub.

Identità

L'identità consente all'utente di fornire il tipo di identità da utilizzare e di stampare la stringa di identità che può essere utilizzata per le modifiche ai criteri IAM.

Rappresentazione JSON 
{
  "name": string,
  "type": enum (IdentityType)
}
Campi
name

string

Solo output. Nome dell'identità.
type

enum (IdentityType)

Tipo di identità da utilizzare per la configurazione del set di dati.

IdentityType

Tipo di account di servizio da utilizzare per la configurazione del set di dati.

Enum
IDENTITY_TYPE_UNSPECIFIED Il valore predefinito non è specificato e non deve essere utilizzato.
IDENTITY_TYPE_PER_CONFIG Un account di servizio gestito da Google per risorsa.
IDENTITY_TYPE_PER_PROJECT Un account di servizio gestito da Google per progetto.

ConfigState

Stato della configurazione.

Enum
CONFIG_STATE_UNSPECIFIED Stato non specificato.
CONFIG_STATE_ACTIVE La configurazione attiva indica che la configurazione sta importando attivamente i dati.
CONFIG_STATE_VERIFICATION_IN_PROGRESS In questo stato, la configurazione viene verificata per varie autorizzazioni.
CONFIG_STATE_CREATED La configurazione è stata creata ed è necessario un'ulteriore elaborazione.
CONFIG_STATE_PROCESSING La configurazione è in corso di elaborazione

Metodi

create

 Crea una configurazione del set di dati in un determinato progetto per una determinata località.

delete

 Consente di eliminare una configurazione del set di dati in un determinato progetto per una determinata località.

get

 Recupera la configurazione del set di dati in un determinato progetto per una determinata località.

linkDataset

 Collega un set di dati a BigQuery in un determinato progetto per una determinata posizione.

list

 Elenca le configurazioni dei set di dati in un determinato progetto per una determinata località.

patch

 Aggiorna la configurazione di un set di dati in un determinato progetto per una determinata località.

unlinkDataset

 Scollega un set di dati da BigQuery in un determinato progetto per una determinata posizione.