Cloud Asset API
The Cloud Asset API manages the history and inventory of Google Cloud resources.
Developer tools#openapi#analytics#media
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
The Cloud Asset API manages the history and inventory of Google Cloud resources.
Endpoints 20
assets
- GETLists assets with time and resource types and returns paged results in response.
/v1/:parent/assets?assetTypes=string&contentType=CONTENT_TYPE_UNSPECIFIED&pageSize=0&pageToken=string&readTime=string&relationshipTypes=stringLists assets with time and resource types and returns paged results in response.
effectiveIamPolicies
- GETGets effective IAM policies for a batch of resources.
/v1/:scope/effectiveIamPolicies:batchGet?names=stringGets effective IAM policies for a batch of resources.
feeds
- GETLists all asset feeds in a parent project/folder/organization.
/v1/:parent/feedsLists all asset feeds in a parent project/folder/organization. - POSTCreates a feed in a parent project/folder/organization to listen to its asset updates.
/v1/:parent/feedsCreates a feed in a parent project/folder/organization to listen to its asset updates.
savedQueries
- GETGets details about a saved query.
/v1/:nameGets details about a saved query. - DELETEDeletes a saved query.
/v1/:nameDeletes a saved query. - PATCHUpdates a saved query.
/v1/:name?updateMask=stringUpdates a saved query. - GETLists all saved queries in a parent project/folder/organization.
/v1/:parent/savedQueries?filter=string&pageSize=0&pageToken=stringLists all saved queries in a parent project/folder/organization. - POSTCreates a saved query in a parent project/folder/organization.
/v1/:parent/savedQueries?savedQueryId=stringCreates a saved query in a parent project/folder/organization.
v1
- GETAnalyzes IAM policies to answer which identities have what accesses on which resources.
/v1/:scope:analyzeIamPolicy?analysisQuery.accessSelector.permissions=string&analysisQuery.accessSelector.roles=string&analysisQuery.conditionContext.accessTime=string&analysisQuery.identitySelector.identity=string&analysisQuery.options.analyzeServiceAccountImpersonation=true&analysisQuery.options.expandGroups=true&analysisQuery.options.expandResources=true&analysisQuery.options.expandRoles=true&analysisQuery.options.outputGroupEdges=true&analysisQuery.options.outputResourceEdges=true&analysisQuery.resourceSelector.fullResourceName=string&executionTimeout=string&savedAnalysisQuery=stringAnalyzes IAM policies to answer which identities have what accesses on which resources. - POSTAnalyzes IAM policies asynchronously to answer which identities have what accesses on which resources, and writes the…
/v1/:scope:analyzeIamPolicyLongrunningAnalyzes IAM policies asynchronously to answer which identities have what accesses on which resources, and writes the analysis results to a Google Cloud… - GETAnalyze moving a resource to a specified destination without kicking off the actual move
/v1/:resource:analyzeMove?destinationParent=string&view=ANALYSIS_VIEW_UNSPECIFIEDAnalyze moving a resource to a specified destination without kicking off the actual move. The analysis is best effort depending on the user's permissions of… - GETAnalyzes organization policies under a scope.
/v1/:scope:analyzeOrgPolicies?constraint=string&filter=string&pageSize=0&pageToken=stringAnalyzes organization policies under a scope. - GETAnalyzes organization policies governed assets (Google Cloud resources or policies) under a scope
/v1/:scope:analyzeOrgPolicyGovernedAssets?constraint=string&filter=string&pageSize=0&pageToken=stringAnalyzes organization policies governed assets (Google Cloud resources or policies) under a scope. This RPC supports custom constraints and the following… - GETAnalyzes organization policies governed containers (projects, folders or organization) under a scope.
/v1/:scope:analyzeOrgPolicyGovernedContainers?constraint=string&filter=string&pageSize=0&pageToken=stringAnalyzes organization policies governed containers (projects, folders or organization) under a scope. - GETBatch gets the update history of assets that overlap a time window
/v1/:parent:batchGetAssetsHistory?assetNames=string&contentType=CONTENT_TYPE_UNSPECIFIED&readTimeWindow.endTime=string&readTimeWindow.startTime=string&relationshipTypes=stringBatch gets the update history of assets that overlap a time window. For IAM_POLICY content, this API outputs history when the asset and its attached IAM… - POSTExports assets with time and resource types to a given Cloud Storage location/BigQuery table
/v1/:parent:exportAssetsExports assets with time and resource types to a given Cloud Storage location/BigQuery table. For Cloud Storage location destinations, the output format is… - POSTIssue a job that queries assets using a SQL statement compatible with [BigQuery…
/v1/:parent:queryAssetsIssue a job that queries assets using a SQL statement compatible with BigQuery SQL. If the query execution finishes within timeout and there's no pagination,… - GETSearches all IAM policies within the specified scope, such as a project, folder, or organization
/v1/:scope:searchAllIamPolicies?assetTypes=string&orderBy=string&pageSize=0&pageToken=string&query=stringSearches all IAM policies within the specified scope, such as a project, folder, or organization. The caller must be granted the… - GETSearches all Google Cloud resources within the specified scope, such as a project, folder, or organization
/v1/:scope:searchAllResources?assetTypes=string&orderBy=string&pageSize=0&pageToken=string&query=string&readMask=stringSearches all Google Cloud resources within the specified scope, such as a project, folder, or organization. The caller must be granted the…
API details
- Base URL
https://cloudasset.googleapis.com- Authentication
- OAuth 2.0 (authorization code flow) with 2 scopes
An API key in the key query parameter - Operations
- 20 operations on 16 pathsGET 13POST 5PATCH 1DELETE 1
- Main resources
- v1 11savedQueries 5feeds 2assets 1effectiveIamPolicies 1
- Response formats
application/json- Description format
- Google API Discovery, API version
v1 - Links
- Documentation · OpenAPI document
- Listed from
- Google API Discovery document (googleapis/discovery-artifact-manager) (Apache-2.0)
How to test the Cloud Asset API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Cloud Asset API collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 2 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Lists assets with time and resource types and returns paged results in response.” (GET /v1/:parent/assets?assetTypes=string&contentType=CONTENT_TYPE_UNSPECIFIED&pageSize=0&pageToken=string&readTime=string&relationshipTypes=string), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Cloud Asset API?
The Cloud Asset API manages the history and inventory of Google Cloud resources. It is listed under Developer tools and has 20 endpoints.
Who publishes the Cloud Asset API?
It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Cloud Asset API?
Requests go to https://cloudasset.googleapis.com. Endpoint paths are added to this base URL.
How do I authenticate with the Cloud Asset API?
It accepts 2 methods: OAuth 2.0 (authorization code flow) with 2 scopes; an API key in the key query parameter.
How many endpoints does the Cloud Asset API have?
20 operations on 16 paths (13 GET, 5 POST, 1 PATCH, 1 DELETE). The largest groups are v1, savedQueries, feeds, assets.
Is forking the Cloud Asset API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.