Cloud Asset API (cloudasset:v1p4beta1)

2022-06-21

2 removed methods | Removed API

Deletions

    Methods
  • cloudasset.analyzeIamPolicy

      Flat Path: v1p4beta1/{v1p4beta1Id}/{v1p4beta1Id1}:analyzeIamPolicy

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

      Path: v1p4beta1/{+parent}:analyzeIamPolicy

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Parameters:

        analysisQuery.accessSelector.permissions

          Description: Optional. The permissions to appear in result.

          Type: string

          Location: query

          Repeated: Yes

        options.analyzeServiceAccountImpersonation

          Location: query

          Type: boolean

          Description: Optional. If true, the response will include access analysis from identities to resources via service account impersonation. This is a very expensive operation, because many derived queries will be executed. We highly recommend you use AssetService.ExportIamPolicyAnalysis rpc instead. For example, if the request analyzes for which resources user A has permission P, and there's an IAM policy states user A has iam.serviceAccounts.getAccessToken permission to a service account SA, and there's another IAM policy states service account SA has permission P to a GCP folder F, then user A potentially has access to the GCP folder F. And those advanced analysis results will be included in AnalyzeIamPolicyResponse.service_account_impersonation_analysis. Another example, if the request analyzes for who has permission P to a GCP folder F, and there's an IAM policy states user A has iam.serviceAccounts.actAs permission to a service account SA, and there's another IAM policy states service account SA has permission P to the GCP folder F, then user A potentially has access to the GCP folder F. And those advanced analysis results will be included in AnalyzeIamPolicyResponse.service_account_impersonation_analysis. Default is false.

        analysisQuery.resourceSelector.fullResourceName

          Location: query

          Description: Required. The [full resource name](https://cloud.google.com/asset-inventory/docs/resource-name-format) of a resource of [supported resource types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#analyzable_asset_types).

          Type: string

        options.outputResourceEdges

          Description: Optional. If true, the result will output resource edges, starting from the policy attached resource, to any expanded resources. Default is false.

          Location: query

          Type: boolean

        options.expandRoles

          Location: query

          Description: Optional. If true, the access section of result will expand any roles appearing in IAM policy bindings to include their permissions. If access_selector is specified, the access section of the result will be determined by the selector, and this flag will have no effect. Default is false.

          Type: boolean

        options.outputGroupEdges

          Description: Optional. If true, the result will output group identity edges, starting from the binding's group members, to any expanded identities. Default is false.

          Location: query

          Type: boolean

        options.expandResources

          Location: query

          Description: Optional. If true, the resource section of the result will expand any resource attached to an IAM policy to include resources lower in the resource hierarchy. For example, if the request analyzes for which resources user A has permission P, and the results include an IAM policy with P on a GCP folder, the results will also include resources in that folder with permission P. If resource_selector is specified, the resource section of the result will be determined by the selector, and this flag will have no effect. Default is false.

          Type: boolean

        analysisQuery.identitySelector.identity

          Description: Required. The identity appear in the form of members in [IAM policy binding](https://cloud.google.com/iam/reference/rest/v1/Binding). The examples of supported forms are: "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com". Notice that wildcard characters (such as * and ?) are not supported. You must give a specific identity.

          Type: string

          Location: query

        options.executionTimeout

          Type: string

          Location: query

          Description: Optional. Amount of time executable has to complete. See JSON representation of [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json). If this field is set with a value less than the RPC deadline, and the execution of your query hasn't finished in the specified execution timeout, you will get a response with partial result. Otherwise, your query's execution will continue until the RPC deadline. If it's not finished until then, you will get a DEADLINE_EXCEEDED error. Default is empty.

          Format: google-duration

        parent

          Description: Required. The relative name of the root asset. Only resources and IAM policies within the parent will be analyzed. This can only be an organization number (such as "organizations/123"), a folder number (such as "folders/123"), a project ID (such as "projects/my-project-id"), or a project number (such as "projects/12345"). To know how to get organization id, visit [here ](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). To know how to get folder or project id, visit [here ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#viewing_or_listing_folders_and_projects).

          Location: path

          Pattern: ^[^/]+/[^/]+$

          Type: string

          Required: Yes

        options.expandGroups

          Description: Optional. If true, the identities section of the result will expand any Google groups appearing in an IAM policy binding. If identity_selector is specified, the identity in the result will be determined by the selector, and this flag will have no effect. Default is false.

          Type: boolean

          Location: query

        analysisQuery.accessSelector.roles

          Repeated: Yes

          Location: query

          Description: Optional. The roles to appear in result.

          Type: string

      Parameter Order: parent

      HTTP Method: GET

  • cloudasset.exportIamPolicyAnalysis

      Path: v1p4beta1/{+parent}:exportIamPolicyAnalysis

      Parameter Order: parent

      Description: Exports the answers of which identities have what accesses on which resources to a Google Cloud Storage destination. The output format is the JSON format that represents a AnalyzeIamPolicyResponse in the JSON format. This method implements the google.longrunning.Operation, 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. The metadata contains the request to help callers to map responses to requests.

      Flat Path: v1p4beta1/{v1p4beta1Id}/{v1p4beta1Id1}:exportIamPolicyAnalysis

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Parameters:

        parent

          Location: path

          Type: string

          Required: Yes

          Pattern: ^[^/]+/[^/]+$

          Description: Required. The relative name of the root asset. Only resources and IAM policies within the parent will be analyzed. This can only be an organization number (such as "organizations/123"), a folder number (such as "folders/123"), a project ID (such as "projects/my-project-id"), or a project number (such as "projects/12345"). To know how to get organization id, visit [here ](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). To know how to get folder or project id, visit [here ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#viewing_or_listing_folders_and_projects).

      HTTP Method: POST