datasets

Creates, updates, deletes, gets or lists a datasets resource.

Overview

Name	datasets
Type	Resource
Id	google.observability.datasets

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Identifier. Name of the dataset. The format is: projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
createTime	string (google-datetime)	Output only. Create timestamp.
deleteTime	string (google-datetime)	Output only. Delete timestamp.
description	string	Optional. Description of the dataset.
displayName	string	Optional. User friendly display name.
purgeTime	string (google-datetime)	Output only. Timestamp when the dataset in soft-deleted state is purged.

list

Name	Datatype	Description
name	string	Identifier. Name of the dataset. The format is: projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
createTime	string (google-datetime)	Output only. Create timestamp.
deleteTime	string (google-datetime)	Output only. Delete timestamp.
description	string	Optional. Description of the dataset.
displayName	string	Optional. User friendly display name.
purgeTime	string (google-datetime)	Output only. Timestamp when the dataset in soft-deleted state is purged.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, bucketsId, datasetsId		Get a dataset.
list	select	projectsId, locationsId, bucketsId	pageSize, pageToken, showDeleted	List datasets of a bucket.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
bucketsId	string
datasetsId	string
locationsId	string
projectsId	string
pageSize	integer (int32)
pageToken	string
showDeleted	boolean

SELECT examples

get

Get a dataset.

SELECT
name,
createTime,
deleteTime,
description,
displayName,
purgeTime
FROM google.observability.datasets
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND datasetsId = '{{ datasetsId }}' -- required
;

list

List datasets of a bucket.

SELECT
name,
createTime,
deleteTime,
description,
displayName,
purgeTime
FROM google.observability.datasets
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND showDeleted = '{{ showDeleted }}'
;