As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Types for Google Cloud Asset v1p5beta1 API

class google.cloud.asset_v1p5beta1.types.Asset(mapping=None, **kwargs)[source]

Cloud asset. This includes all Google Cloud Platform resources, Cloud IAM policies, and other non-GCP assets.

name

The full name of the asset. For example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See Resource Names for more information.

Type

str

asset_type

Type of the asset. Example: “compute.googleapis.com/Disk”.

Type

str

resource

Representation of the resource.

Type

Resource

iam_policy

Representation of the actual Cloud IAM policy set on a cloud resource. For each resource, there must be at most one Cloud IAM policy set on it.

Type

Policy

org_policy

Representation of the Cloud Organization Policy set on an asset. For each asset, there could be multiple Organization policies with different constraints.

Type

Sequence[Policy]

access_policy
Type

AccessPolicy

access_level
Type

AccessLevel

service_perimeter
Type

ServicePerimeter

ancestors

Asset’s ancestry path in Cloud Resource Manager (CRM) hierarchy, represented as a list of relative resource names. Ancestry path starts with the closest CRM ancestor and ends at root. If the asset is a CRM project/folder/organization, this starts from the asset itself.

Example: [“projects/123456789”, “folders/5432”, “organizations/1234”]

Type

Sequence[str]

class google.cloud.asset_v1p5beta1.types.Resource(mapping=None, **kwargs)[source]

Representation of a cloud resource.

version

The API version. Example: “v1”.

Type

str

discovery_document_uri

The URL of the discovery document containing the resource’s JSON schema. For example: "https://www.googleapis.com/discovery/v1/apis/compute/v1/rest". It will be left unspecified for resources without a discovery-based API, such as Cloud Bigtable.

Type

str

discovery_name

The JSON schema name listed in the discovery document. Example: “Project”. It will be left unspecified for resources (such as Cloud Bigtable) without a discovery-based API.

Type

str

resource_url

The REST URL for accessing the resource. An HTTP GET operation using this URL returns the resource itself. Example: https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123. It will be left unspecified for resources without a REST API.

Type

str

parent

The full name of the immediate parent of this resource. See Resource Names for more information.

For GCP assets, it is the parent resource defined in the Cloud IAM policy hierarchy. For example: "//cloudresourcemanager.googleapis.com/projects/my_project_123".

For third-party assets, it is up to the users to define.

Type

str

data

The content of the resource, in which some sensitive fields are scrubbed away and may not be present.

Type

Struct

class google.cloud.asset_v1p5beta1.types.ListAssetsRequest(mapping=None, **kwargs)[source]

ListAssets request.

parent

Required. Name of the organization or project the assets belong to. Format: “organizations/[organization-number]” (such as “organizations/123”), “projects/[project-number]” (such as “projects/my-project-id”), or “projects/[project-id]” (such as “projects/12345”).

Type

str

read_time

Timestamp to take an asset snapshot. This can only be set to a timestamp between 2018-10-02 UTC (inclusive) and the current time. If not specified, the current time will be used. Due to delays in resource data collection and indexing, there is a volatile window during which running the same query may get different results.

Type

Timestamp

asset_types

A list of asset types of which to take a snapshot for. For example: “compute.googleapis.com/Disk”. If specified, only matching assets will be returned. See Introduction to Cloud Asset Inventory for all supported asset types.

Type

Sequence[str]

content_type

Asset content type. If not specified, no content but the asset name will be returned.

Type

ContentType

page_size

The maximum number of assets to be returned in a single response. Default is 100, minimum is 1, and maximum is 1000.

Type

int

page_token

The next_page_token returned from the previous ListAssetsResponse, or unspecified for the first ListAssetsRequest. It is a continuation of a prior ListAssets call, and the API should return the next page of assets.

Type

str

class google.cloud.asset_v1p5beta1.types.ListAssetsResponse(mapping=None, **kwargs)[source]

ListAssets response.

read_time

Time the snapshot was taken.

Type

Timestamp

assets

Assets.

Type

Sequence[Asset]

next_page_token

Token to retrieve the next page of results. Set to empty if there are no remaining results.

Type

str