views

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

Overview

Name	views
Type	Resource
Id	google.logging.views

Fields

The following fields are returned by SELECT queries:

projects_locations_buckets_views_get

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

organizations_locations_buckets_views_get

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

folders_locations_buckets_views_get

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

billing_accounts_locations_buckets_views_get

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

projects_locations_buckets_views_list

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

organizations_locations_buckets_views_list

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

folders_locations_buckets_views_list

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

billing_accounts_locations_buckets_views_list

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

locations_buckets_views_list

Successful response

Name	Datatype	Description
name	string	Output only. The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
createTime	string (google-datetime)	Output only. The creation timestamp of the view.
description	string	Optional. Describes this view.
filter	string	Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
updateTime	string (google-datetime)	Output only. The last update timestamp of the view.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_buckets_views_get	select	projectsId, locationsId, bucketsId, viewsId		Gets a view on a log bucket.
organizations_locations_buckets_views_get	select	organizationsId, locationsId, bucketsId, viewsId		Gets a view on a log bucket.
folders_locations_buckets_views_get	select	foldersId, locationsId, bucketsId, viewsId		Gets a view on a log bucket.
billing_accounts_locations_buckets_views_get	select	billingAccountsId, locationsId, bucketsId, viewsId		Gets a view on a log bucket.
projects_locations_buckets_views_list	select	projectsId, locationsId, bucketsId	pageToken, pageSize	Lists views on a log bucket.
organizations_locations_buckets_views_list	select	organizationsId, locationsId, bucketsId	pageToken, pageSize	Lists views on a log bucket.
folders_locations_buckets_views_list	select	foldersId, locationsId, bucketsId	pageToken, pageSize	Lists views on a log bucket.
billing_accounts_locations_buckets_views_list	select	billingAccountsId, locationsId, bucketsId	pageToken, pageSize	Lists views on a log bucket.
locations_buckets_views_list	select	parentType, parent	pageToken, pageSize	Lists views on a log bucket.
projects_locations_buckets_views_create	insert	projectsId, locationsId, bucketsId	viewId	Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.
organizations_locations_buckets_views_create	insert	organizationsId, locationsId, bucketsId	viewId	Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.
folders_locations_buckets_views_create	insert	foldersId, locationsId, bucketsId	viewId	Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.
billing_accounts_locations_buckets_views_create	insert	billingAccountsId, locationsId, bucketsId	viewId	Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.
locations_buckets_views_create	insert	parentType, parent	viewId	Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.
projects_locations_buckets_views_patch	update	projectsId, locationsId, bucketsId, viewsId	updateMask	Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.
organizations_locations_buckets_views_patch	update	organizationsId, locationsId, bucketsId, viewsId	updateMask	Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.
folders_locations_buckets_views_patch	update	foldersId, locationsId, bucketsId, viewsId	updateMask	Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.
billing_accounts_locations_buckets_views_patch	update	billingAccountsId, locationsId, bucketsId, viewsId	updateMask	Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.
projects_locations_buckets_views_delete	delete	projectsId, locationsId, bucketsId, viewsId		Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.
organizations_locations_buckets_views_delete	delete	organizationsId, locationsId, bucketsId, viewsId		Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.
folders_locations_buckets_views_delete	delete	foldersId, locationsId, bucketsId, viewsId		Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.
billing_accounts_locations_buckets_views_delete	delete	billingAccountsId, locationsId, bucketsId, viewsId		Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.

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
billingAccountsId	string
bucketsId	string
foldersId	string
locationsId	string
organizationsId	string
parent	string
parentType	string
projectsId	string
viewsId	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)
viewId	string

SELECT examples

projects_locations_buckets_views_get

Gets a view on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND viewsId = '{{ viewsId }}' -- required;

organizations_locations_buckets_views_get

Gets a view on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND viewsId = '{{ viewsId }}' -- required;

folders_locations_buckets_views_get

Gets a view on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE foldersId = '{{ foldersId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND viewsId = '{{ viewsId }}' -- required;

billing_accounts_locations_buckets_views_get

Gets a view on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE billingAccountsId = '{{ billingAccountsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND viewsId = '{{ viewsId }}' -- required;

projects_locations_buckets_views_list

Lists views on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}';

organizations_locations_buckets_views_list

Lists views on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}';

folders_locations_buckets_views_list

Lists views on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE foldersId = '{{ foldersId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}';

billing_accounts_locations_buckets_views_list

Lists views on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE billingAccountsId = '{{ billingAccountsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND bucketsId = '{{ bucketsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}';

locations_buckets_views_list

Lists views on a log bucket.

SELECT
name,
createTime,
description,
filter,
updateTime
FROM google.logging.views
WHERE parentType = '{{ parentType }}' -- required
AND parent = '{{ parent }}' -- required
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}';

INSERT examples

projects_locations_buckets_views_create

Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.

INSERT INTO google.logging.views (
data__description,
data__filter,
projectsId,
locationsId,
bucketsId,
viewId
)
SELECT 
'{{ description }}',
'{{ filter }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ bucketsId }}',
'{{ viewId }}'
RETURNING
name,
createTime,
description,
filter,
updateTime
;

organizations_locations_buckets_views_create

Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.

INSERT INTO google.logging.views (
data__description,
data__filter,
organizationsId,
locationsId,
bucketsId,
viewId
)
SELECT 
'{{ description }}',
'{{ filter }}',
'{{ organizationsId }}',
'{{ locationsId }}',
'{{ bucketsId }}',
'{{ viewId }}'
RETURNING
name,
createTime,
description,
filter,
updateTime
;

folders_locations_buckets_views_create

Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.

INSERT INTO google.logging.views (
data__description,
data__filter,
foldersId,
locationsId,
bucketsId,
viewId
)
SELECT 
'{{ description }}',
'{{ filter }}',
'{{ foldersId }}',
'{{ locationsId }}',
'{{ bucketsId }}',
'{{ viewId }}'
RETURNING
name,
createTime,
description,
filter,
updateTime
;

billing_accounts_locations_buckets_views_create

Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.

INSERT INTO google.logging.views (
data__description,
data__filter,
billingAccountsId,
locationsId,
bucketsId,
viewId
)
SELECT 
'{{ description }}',
'{{ filter }}',
'{{ billingAccountsId }}',
'{{ locationsId }}',
'{{ bucketsId }}',
'{{ viewId }}'
RETURNING
name,
createTime,
description,
filter,
updateTime
;

locations_buckets_views_create

Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.

INSERT INTO google.logging.views (
data__description,
data__filter,
parentType,
parent,
viewId
)
SELECT 
'{{ description }}',
'{{ filter }}',
'{{ parentType }}',
'{{ parent }}',
'{{ viewId }}'
RETURNING
name,
createTime,
description,
filter,
updateTime
;

Manifest

# Description fields are for documentation purposes
- name: views
  props:
    - name: projectsId
      value: string
      description: Required parameter for the views resource.
    - name: locationsId
      value: string
      description: Required parameter for the views resource.
    - name: bucketsId
      value: string
      description: Required parameter for the views resource.
    - name: organizationsId
      value: string
      description: Required parameter for the views resource.
    - name: foldersId
      value: string
      description: Required parameter for the views resource.
    - name: billingAccountsId
      value: string
      description: Required parameter for the views resource.
    - name: parentType
      value: string
      description: Required parameter for the views resource.
    - name: parent
      value: string
      description: Required parameter for the views resource.
    - name: description
      value: string
      description: >
        Optional. Describes this view.
        
    - name: filter
      value: string
      description: >
        Optional. Filter that restricts which log entries in a bucket are visible in this view.Filters must be logical conjunctions that use the AND operator, and they can use any of the following qualifiers: SOURCE(), which specifies a project, folder, organization, or billing account of origin. resource.type, which specifies the resource type. LOG_ID(), which identifies the log.They can also use the negations of these qualifiers with the NOT operator.For example:SOURCE("projects/myproject") AND resource.type = "gce_instance" AND NOT LOG_ID("stdout")
        
    - name: viewId
      value: string

UPDATE examples

projects_locations_buckets_views_patch

Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.

UPDATE google.logging.views
SET 
data__description = '{{ description }}',
data__filter = '{{ filter }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND bucketsId = '{{ bucketsId }}' --required
AND viewsId = '{{ viewsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
createTime,
description,
filter,
updateTime;

organizations_locations_buckets_views_patch

Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.

UPDATE google.logging.views
SET 
data__description = '{{ description }}',
data__filter = '{{ filter }}'
WHERE 
organizationsId = '{{ organizationsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND bucketsId = '{{ bucketsId }}' --required
AND viewsId = '{{ viewsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
createTime,
description,
filter,
updateTime;

folders_locations_buckets_views_patch

Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.

UPDATE google.logging.views
SET 
data__description = '{{ description }}',
data__filter = '{{ filter }}'
WHERE 
foldersId = '{{ foldersId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND bucketsId = '{{ bucketsId }}' --required
AND viewsId = '{{ viewsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
createTime,
description,
filter,
updateTime;

billing_accounts_locations_buckets_views_patch

Updates a view on a log bucket. This method replaces the value of the filter field from the existing view with the corresponding value from the new view. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.

UPDATE google.logging.views
SET 
data__description = '{{ description }}',
data__filter = '{{ filter }}'
WHERE 
billingAccountsId = '{{ billingAccountsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND bucketsId = '{{ bucketsId }}' --required
AND viewsId = '{{ viewsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
createTime,
description,
filter,
updateTime;

DELETE examples

projects_locations_buckets_views_delete

Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.

DELETE FROM google.logging.views
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND bucketsId = '{{ bucketsId }}' --required
AND viewsId = '{{ viewsId }}' --required;

organizations_locations_buckets_views_delete

Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.

DELETE FROM google.logging.views
WHERE organizationsId = '{{ organizationsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND bucketsId = '{{ bucketsId }}' --required
AND viewsId = '{{ viewsId }}' --required;

folders_locations_buckets_views_delete

Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.

DELETE FROM google.logging.views
WHERE foldersId = '{{ foldersId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND bucketsId = '{{ bucketsId }}' --required
AND viewsId = '{{ viewsId }}' --required;

billing_accounts_locations_buckets_views_delete

Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.

DELETE FROM google.logging.views
WHERE billingAccountsId = '{{ billingAccountsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND bucketsId = '{{ bucketsId }}' --required
AND viewsId = '{{ viewsId }}' --required;