REST Resource: projects.locations.datasetConfigs

Risorsa: DatasetConfig

Messaggio che descrive le proprietà di configurazione del set di dati. Per maggiori 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.
  "activityDataRetentionPeriodDays": integer
}
Campi
name

string

Identifier. name of resource
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 è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 in cui è stato aggiornato per l'ultima volta il set di dati. Questo campo viene compilato automaticamente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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. ID risorsa 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 di 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 tipi:
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 un mix 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 tipi:
includeCloudStorageLocations

object (CloudStorageLocations)
excludeCloudStorageLocations

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

object (CloudStorageBuckets)
excludeCloudStorageBuckets

object (CloudStorageBuckets)
activityDataRetentionPeriodDays

integer

Facoltativo. Se impostato, sostituisce il periodo di conservazione dei dati delle attività. Se non è impostato, i dati sull'attività utilizzano il valore specificato in retentionPeriodDays.

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 cartella 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 con 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 tipi:
bucketName

string

Nome del bucket Cloud Storage.
bucketPrefixRegex

string

Un pattern regex per i nomi dei bucket che corrispondono alla regex. L'espressione regolare deve seguire la sintassi specificata in google/re2 su GitHub.

Identità

Identity consente all'utente di fornire il tipo di identità da utilizzare e restituisce 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. Il nome dell'identità.
type

enum (IdentityType)

Tipo di identità da utilizzare per datasetConfig.

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 Account di servizio gestito da Google per risorsa.
IDENTITY_TYPE_PER_PROJECT 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 i dati vengono inseriti attivamente.
CONFIG_STATE_VERIFICATION_IN_PROGRESS In questo stato, la configurazione viene verificata per varie autorizzazioni.
CONFIG_STATE_CREATED La configurazione viene creata e deve essere eseguita un'ulteriore elaborazione.
CONFIG_STATE_PROCESSING La configurazione è in fase di elaborazione

Metodi

create

 Crea una configurazione del set di dati in un progetto specifico per una località specifica.

delete

 Elimina una configurazione del set di dati in un progetto specifico per una località specifica.

get

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

linkDataset

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

list

 Elenca le configurazioni del set di dati in un progetto specifico per una località specifica.

patch

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

unlinkDataset

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