Index
-
AssetService
(interface) -
IamPolicySearchResult
(message) -
IamPolicySearchResult.Explanation
(message) -
Permissions
(message) -
SearchAllIamPoliciesRequest
(message) -
SearchAllIamPoliciesResponse
(message) -
SearchAllResourcesRequest
(message) -
SearchAllResourcesResponse
(message) -
StandardResourceMetadata
(message)
AssetService
Asset service definition.
rpc SearchAllIamPolicies(
SearchAllIamPoliciesRequest
) returns ( SearchAllIamPoliciesResponse
)
Searches all the IAM policies within a given accessible Resource Manager scope (project/folder/organization). This RPC gives callers especially administrators the ability to search all the IAM policies within a scope, even if they don't have .getIamPolicy
permission of all the IAM policies. Callers should have cloudasset.assets.searchAllIamPolicies
permission on the requested scope, otherwise the request will be rejected.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
-
rpc SearchAllResources(
SearchAllResourcesRequest
) returns ( SearchAllResourcesResponse
)
Searches all the resources within a given accessible Resource Manager scope (project/folder/organization). This RPC gives callers especially administrators the ability to search all the resources within a scope, even if they don't have .get
permission of all the resources. Callers should have cloudasset.assets.searchAllResources
permission on the requested scope, otherwise the request will be rejected.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
-
IamPolicySearchResult
The result for an IAM policy search.
Fields | |
---|---|
resource
|
The full resource name of the resource associated with this IAM policy. |
project
|
The project that the associated Google Cloud resource belongs to, in the form of |
policy
|
The IAM policy attached to the specified resource. Note that the original IAM policy can contain multiple bindings. This only contains the bindings that match the given query. For queries that don't contain a constraint on policies (e.g. an empty query), this contains all the bindings. |
explanation
|
Explanation about the IAM policy search result. It contains additional information that explains why the search result matches the query. |
Explanation
Explanation about the IAM policy search result.
Fields | |
---|---|
matched_permissions
|
The map from roles to their included permission matching the permission query (e.g. containing |
Permissions
IAM permissions.
Fields | |
---|---|
permissions[]
|
A list of permissions. Example permission string: "compute.disk.get". |
SearchAllIamPoliciesRequest
Search all IAM policies request.
scope
string
Required. The relative name of an asset. The search is limited to the resources within the scope
. The allowed value must be:
- Organization number (such as "organizations/123")
- Folder number (such as "folders/1234")
- Project number (such as "projects/12345")
- Project ID (such as "projects/abc")
Authorization requires the following IAM
permission on the specified resource scope
:
-
cloudasset.assets.searchAllIamPolicies
query
string
Optional. The query statement. Examples:
- "policy: myuser@mydomain.com "
- "policy:( myuser@mydomain.com viewer)"
page_size
int32
Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as next_page_token
is returned.
page_token
string
Optional. If present, retrieve the next batch of results from the preceding call to this method. page_token
must be the value of next_page_token
from the previous response. The values of all other method parameters must be identical to those in the previous call.
SearchAllIamPoliciesResponse
Search all IAM policies response.
Fields | |
---|---|
results[]
|
A list of IAM policies that match the search query. Related information such as the associated resource is returned along with the policy. |
next_page_token
|
Set if there are more results than those appearing in this response; to get the next set of results, call this method again, using this value as the |
SearchAllResourcesRequest
Search all resources request.
scope
string
Required. The relative name of an asset. The search is limited to the resources within the scope
. The allowed value must be:
- Organization number (such as "organizations/123")
- Folder number (such as "folders/1234")
- Project number (such as "projects/12345")
- Project ID (such as "projects/abc")
Authorization requires the following IAM
permission on the specified resource scope
:
-
cloudasset.assets.searchAllResources
query
string
Optional. The query statement.
asset_types[]
string
Optional. A list of asset types that this request searches for. If empty, it will search all the supported asset types.
page_size
int32
Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as next_page_token
is returned.
page_token
string
Optional. If present, then retrieve the next batch of results from the preceding call to this method. page_token
must be the value of next_page_token
from the previous response. The values of all other method parameters, must be identical to those in the previous call.
order_by
string
Optional. A comma separated list of fields specifying the sorting order of the results. The default order is ascending. Add DESC
after the field name to indicate descending order. Redundant space characters are ignored. For example, location DESC , name
.
SearchAllResourcesResponse
Search all resources response.
Fields | |
---|---|
results[]
|
A list of resource that match the search query. |
next_page_token
|
If there are more results than those appearing in this response, then |
StandardResourceMetadata
The standard metadata of a cloud resource.
Fields | |
---|---|
name
|
The full resource name. For example: |
asset_type
|
The type of this resource. For example: "compute.googleapis.com/Disk". |
project
|
The project that this resource belongs to, in the form of |
display_name
|
The display name of this resource. |
description
|
One or more paragraphs of text description of this resource. Maximum length could be up to 1M bytes. |
additional_attributes[]
|
Additional searchable attributes of this resource. Informational only. The exact set of attributes is subject to change. For example: project id, DNS name etc. |
location
|
Location can be "global", regional like "us-east1", or zonal like "us-west1-b". |
labels
|
Labels associated with this resource. See Labelling and grouping Google Cloud resources for more information. |
network_tags[]
|
Network tags associated with this resource. Like labels, network tags are a type of annotations used to group Google Cloud resources. See Labelling Google Cloud resources for more information. |