assets

Creates, updates, deletes, gets or lists an assets resource.

Overview

Name	assets
Type	Resource
Id	google.securitycenter.assets

Fields

The following fields are returned by SELECT queries:

folders_assets_list

Successful response

Name	Datatype	Description
asset	object	Asset matching the search request. (id: Asset)
stateChange	string	State change of the asset between the points in time.

projects_assets_list

Successful response

Name	Datatype	Description
asset	object	Asset matching the search request. (id: Asset)
stateChange	string	State change of the asset between the points in time.

organizations_assets_list

Successful response

Name	Datatype	Description
asset	object	Asset matching the search request. (id: Asset)
stateChange	string	State change of the asset between the points in time.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
folders_assets_list	select	foldersId	filter, orderBy, readTime, compareDuration, fieldMask, pageToken, pageSize	Lists an organization's assets.
projects_assets_list	select	projectsId	filter, orderBy, readTime, compareDuration, fieldMask, pageToken, pageSize	Lists an organization's assets.
organizations_assets_list	select	organizationsId	filter, orderBy, readTime, compareDuration, fieldMask, pageToken, pageSize	Lists an organization's assets.
folders_assets_group	exec	foldersId		Filters an organization's assets and groups them by their specified properties.
projects_assets_group	exec	projectsId		Filters an organization's assets and groups them by their specified properties.
organizations_assets_group	exec	organizationsId		Filters an organization's assets and groups them by their specified properties.
organizations_assets_run_discovery	exec	organizationsId		Runs asset discovery. The discovery is tracked with a long-running operation. This API can only be called with limited frequency for an organization. If it is called too frequently the caller will receive a TOO_MANY_REQUESTS error.

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
foldersId	string
organizationsId	string
projectsId	string
compareDuration	string (google-duration)
fieldMask	string (google-fieldmask)
filter	string
orderBy	string
pageSize	integer (int32)
pageToken	string
readTime	string (google-datetime)

SELECT examples

folders_assets_list

Lists an organization's assets.

SELECT
asset,
stateChange
FROM google.securitycenter.assets
WHERE foldersId = '{{ foldersId }}' -- required
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
AND readTime = '{{ readTime }}'
AND compareDuration = '{{ compareDuration }}'
AND fieldMask = '{{ fieldMask }}'
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}';

projects_assets_list

Lists an organization's assets.

SELECT
asset,
stateChange
FROM google.securitycenter.assets
WHERE projectsId = '{{ projectsId }}' -- required
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
AND readTime = '{{ readTime }}'
AND compareDuration = '{{ compareDuration }}'
AND fieldMask = '{{ fieldMask }}'
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}';

organizations_assets_list

Lists an organization's assets.

SELECT
asset,
stateChange
FROM google.securitycenter.assets
WHERE organizationsId = '{{ organizationsId }}' -- required
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
AND readTime = '{{ readTime }}'
AND compareDuration = '{{ compareDuration }}'
AND fieldMask = '{{ fieldMask }}'
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}';

Lifecycle Methods

folders_assets_group

Filters an organization's assets and groups them by their specified properties.

EXEC google.securitycenter.assets.folders_assets_group 
@foldersId='{{ foldersId }}' --required 
@@json=
'{
"filter": "{{ filter }}", 
"groupBy": "{{ groupBy }}", 
"compareDuration": "{{ compareDuration }}", 
"readTime": "{{ readTime }}", 
"pageToken": "{{ pageToken }}", 
"pageSize": {{ pageSize }}
}';

projects_assets_group

Filters an organization's assets and groups them by their specified properties.

EXEC google.securitycenter.assets.projects_assets_group 
@projectsId='{{ projectsId }}' --required 
@@json=
'{
"filter": "{{ filter }}", 
"groupBy": "{{ groupBy }}", 
"compareDuration": "{{ compareDuration }}", 
"readTime": "{{ readTime }}", 
"pageToken": "{{ pageToken }}", 
"pageSize": {{ pageSize }}
}';

organizations_assets_group

Filters an organization's assets and groups them by their specified properties.

EXEC google.securitycenter.assets.organizations_assets_group 
@organizationsId='{{ organizationsId }}' --required 
@@json=
'{
"filter": "{{ filter }}", 
"groupBy": "{{ groupBy }}", 
"compareDuration": "{{ compareDuration }}", 
"readTime": "{{ readTime }}", 
"pageToken": "{{ pageToken }}", 
"pageSize": {{ pageSize }}
}';

organizations_assets_run_discovery

Runs asset discovery. The discovery is tracked with a long-running operation. This API can only be called with limited frequency for an organization. If it is called too frequently the caller will receive a TOO_MANY_REQUESTS error.

EXEC google.securitycenter.assets.organizations_assets_run_discovery 
@organizationsId='{{ organizationsId }}' --required;