Class AssetServiceGrpc.AssetServiceFutureStub (3.26.0)

public static final class AssetServiceGrpc.AssetServiceFutureStub extends AbstractFutureStub<AssetServiceGrpc.AssetServiceFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service AssetService.

Asset service definition.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > AssetServiceGrpc.AssetServiceFutureStub

Methods

analyzeIamPolicy(AnalyzeIamPolicyRequest request)

public ListenableFuture<AnalyzeIamPolicyResponse> analyzeIamPolicy(AnalyzeIamPolicyRequest request)

Analyzes IAM policies to answer which identities have what accesses on which resources.

Parameter
Name Description
request AnalyzeIamPolicyRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AnalyzeIamPolicyResponse>

analyzeIamPolicyLongrunning(AnalyzeIamPolicyLongrunningRequest request)

public ListenableFuture<Operation> analyzeIamPolicyLongrunning(AnalyzeIamPolicyLongrunningRequest request)

Analyzes IAM policies asynchronously to answer which identities have what accesses on which resources, and writes the analysis results to a Google Cloud Storage or a BigQuery destination. For Cloud Storage destination, the output format is the JSON format that represents a AnalyzeIamPolicyResponse. This method implements the google.longrunning.Operation, which allows you to track the operation status. We recommend intervals of at least 2 seconds with exponential backoff retry to poll the operation result. The metadata contains the metadata for the long-running operation.

Parameter
Name Description
request AnalyzeIamPolicyLongrunningRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

analyzeMove(AnalyzeMoveRequest request)

public ListenableFuture<AnalyzeMoveResponse> analyzeMove(AnalyzeMoveRequest request)

Analyze 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 viewing different hierarchical policies and configurations. The policies and configuration are subject to change before the actual resource migration takes place.

Parameter
Name Description
request AnalyzeMoveRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AnalyzeMoveResponse>

analyzeOrgPolicies(AnalyzeOrgPoliciesRequest request)

public ListenableFuture<AnalyzeOrgPoliciesResponse> analyzeOrgPolicies(AnalyzeOrgPoliciesRequest request)

Analyzes organization policies under a scope.

Parameter
Name Description
request AnalyzeOrgPoliciesRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AnalyzeOrgPoliciesResponse>

analyzeOrgPolicyGovernedAssets(AnalyzeOrgPolicyGovernedAssetsRequest request)

public ListenableFuture<AnalyzeOrgPolicyGovernedAssetsResponse> analyzeOrgPolicyGovernedAssets(AnalyzeOrgPolicyGovernedAssetsRequest request)

Analyzes organization policies governed assets (Google Cloud resources or policies) under a scope. This RPC supports custom constraints and the following 10 canned constraints:

  • storage.uniformBucketLevelAccess
  • iam.disableServiceAccountKeyCreation
  • iam.allowedPolicyMemberDomains
  • compute.vmExternalIpAccess
  • appengine.enforceServiceAccountActAsCheck
  • gcp.resourceLocations
  • compute.trustedImageProjects
  • compute.skipDefaultNetworkCreation
  • compute.requireOsLogin
  • compute.disableNestedVirtualization This RPC only returns either resources of types supported by searchable asset types, or IAM policies.
Parameter
Name Description
request AnalyzeOrgPolicyGovernedAssetsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AnalyzeOrgPolicyGovernedAssetsResponse>

analyzeOrgPolicyGovernedContainers(AnalyzeOrgPolicyGovernedContainersRequest request)

public ListenableFuture<AnalyzeOrgPolicyGovernedContainersResponse> analyzeOrgPolicyGovernedContainers(AnalyzeOrgPolicyGovernedContainersRequest request)

Analyzes organization policies governed containers (projects, folders or organization) under a scope.

Parameter
Name Description
request AnalyzeOrgPolicyGovernedContainersRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AnalyzeOrgPolicyGovernedContainersResponse>

batchGetAssetsHistory(BatchGetAssetsHistoryRequest request)

public ListenableFuture<BatchGetAssetsHistoryResponse> batchGetAssetsHistory(BatchGetAssetsHistoryRequest request)

Batch 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 POLICY both exist. This can create gaps in the output history. Otherwise, this API outputs history with asset in both non-delete or deleted status. If a specified asset does not exist, this API returns an INVALID_ARGUMENT error.

Parameter
Name Description
request BatchGetAssetsHistoryRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<BatchGetAssetsHistoryResponse>

batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request)

public ListenableFuture<BatchGetEffectiveIamPoliciesResponse> batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request)

Gets effective IAM policies for a batch of resources.

Parameter
Name Description
request BatchGetEffectiveIamPoliciesRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<BatchGetEffectiveIamPoliciesResponse>

build(Channel channel, CallOptions callOptions)

protected AssetServiceGrpc.AssetServiceFutureStub build(Channel channel, CallOptions callOptions)
Parameters
Name Description
channel io.grpc.Channel
callOptions io.grpc.CallOptions
Returns
Type Description
AssetServiceGrpc.AssetServiceFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

createFeed(CreateFeedRequest request)

public ListenableFuture<Feed> createFeed(CreateFeedRequest request)

Creates a feed in a parent project/folder/organization to listen to its asset updates.

Parameter
Name Description
request CreateFeedRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Feed>

createSavedQuery(CreateSavedQueryRequest request)

public ListenableFuture<SavedQuery> createSavedQuery(CreateSavedQueryRequest request)

Creates a saved query in a parent project/folder/organization.

Parameter
Name Description
request CreateSavedQueryRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<SavedQuery>

deleteFeed(DeleteFeedRequest request)

public ListenableFuture<Empty> deleteFeed(DeleteFeedRequest request)

Deletes an asset feed.

Parameter
Name Description
request DeleteFeedRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteSavedQuery(DeleteSavedQueryRequest request)

public ListenableFuture<Empty> deleteSavedQuery(DeleteSavedQueryRequest request)

Deletes a saved query.

Parameter
Name Description
request DeleteSavedQueryRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

exportAssets(ExportAssetsRequest request)

public ListenableFuture<Operation> exportAssets(ExportAssetsRequest request)

Exports assets with time and resource types to a given Cloud Storage location/BigQuery table. For Cloud Storage location destinations, the output format is newline-delimited JSON. Each line represents a google.cloud.asset.v1.Asset in the JSON format; for BigQuery table destinations, the output table stores the fields in asset Protobuf as columns. This API implements the google.longrunning.Operation API, which allows you to keep track of the export. We recommend intervals of at least 2 seconds with exponential retry to poll the export operation result. For regular-size resource parent, the export operation usually finishes within 5 minutes.

Parameter
Name Description
request ExportAssetsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

getFeed(GetFeedRequest request)

public ListenableFuture<Feed> getFeed(GetFeedRequest request)

Gets details about an asset feed.

Parameter
Name Description
request GetFeedRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Feed>

getSavedQuery(GetSavedQueryRequest request)

public ListenableFuture<SavedQuery> getSavedQuery(GetSavedQueryRequest request)

Gets details about a saved query.

Parameter
Name Description
request GetSavedQueryRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<SavedQuery>

listAssets(ListAssetsRequest request)

public ListenableFuture<ListAssetsResponse> listAssets(ListAssetsRequest request)

Lists assets with time and resource types and returns paged results in response.

Parameter
Name Description
request ListAssetsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListAssetsResponse>

listFeeds(ListFeedsRequest request)

public ListenableFuture<ListFeedsResponse> listFeeds(ListFeedsRequest request)

Lists all asset feeds in a parent project/folder/organization.

Parameter
Name Description
request ListFeedsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListFeedsResponse>

listSavedQueries(ListSavedQueriesRequest request)

public ListenableFuture<ListSavedQueriesResponse> listSavedQueries(ListSavedQueriesRequest request)

Lists all saved queries in a parent project/folder/organization.

Parameter
Name Description
request ListSavedQueriesRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListSavedQueriesResponse>

queryAssets(QueryAssetsRequest request)

public ListenableFuture<QueryAssetsResponse> queryAssets(QueryAssetsRequest request)

Issue a job that queries assets using a SQL statement compatible with BigQuery Standard SQL. If the query execution finishes within timeout and there's no pagination, the full query results will be returned in the QueryAssetsResponse. Otherwise, full query results can be obtained by issuing extra requests with the job_reference from the a previous QueryAssets call. Note, the query result has approximately 10 GB limitation enforced by BigQuery https://cloud.google.com/bigquery/docs/best-practices-performance-output, queries return larger results will result in errors.

Parameter
Name Description
request QueryAssetsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<QueryAssetsResponse>

searchAllIamPolicies(SearchAllIamPoliciesRequest request)

public ListenableFuture<SearchAllIamPoliciesResponse> searchAllIamPolicies(SearchAllIamPoliciesRequest request)

Searches all IAM policies within the specified scope, such as a project, folder, or organization. The caller must be granted the cloudasset.assets.searchAllIamPolicies permission on the desired scope, otherwise the request will be rejected.

Parameter
Name Description
request SearchAllIamPoliciesRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<SearchAllIamPoliciesResponse>

searchAllResources(SearchAllResourcesRequest request)

public ListenableFuture<SearchAllResourcesResponse> searchAllResources(SearchAllResourcesRequest request)

Searches all Google Cloud resources within the specified scope, such as a project, folder, or organization. The caller must be granted the cloudasset.assets.searchAllResources permission on the desired scope, otherwise the request will be rejected.

Parameter
Name Description
request SearchAllResourcesRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<SearchAllResourcesResponse>

updateFeed(UpdateFeedRequest request)

public ListenableFuture<Feed> updateFeed(UpdateFeedRequest request)

Updates an asset feed configuration.

Parameter
Name Description
request UpdateFeedRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Feed>

updateSavedQuery(UpdateSavedQueryRequest request)

public ListenableFuture<SavedQuery> updateSavedQuery(UpdateSavedQueryRequest request)

Updates a saved query.

Parameter
Name Description
request UpdateSavedQueryRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<SavedQuery>