Security Command Center API (securitycenter:v1)

2023-08-02

11 new methods | 12 removed methods

Additions

    Methods
  • securitycenter.organizations.resourceValueConfigs.list

      Description: Lists all ResourceValueConfigs.

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

      Parameter Order: parent

      Path: v1/{+parent}/resourceValueConfigs

      HTTP Method: GET

      Flat Path: v1/organizations/{organizationsId}/resourceValueConfigs

      Parameters:

        parent

          Type: string

          Pattern: ^organizations/[^/]+$

          Required: Yes

          Description: Required. The parent, which owns the collection of resource value configs. Its format is "organizations/[organization_id]"

          Location: path

        pageSize

          Format: int32

          Type: integer

          Location: query

          Description: The number of results to return. The service may return fewer than this value. If unspecified, at most 10 configs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

        pageToken

          Description: A page token, received from a previous `ListResourceValueConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListResourceValueConfigs` must match the call that provided the page token. page_size can be specified, and the new page_size will be used.

          Location: query

          Type: string

  • securitycenter.organizations.resourceValueConfigs.batchCreate

      Flat Path: v1/organizations/{organizationsId}/resourceValueConfigs:batchCreate

      Description: Creates a ResourceValueConfig for an organization. Maps user's tags to difference resource values for use by the attack path simulation.

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

      Parameters:

        parent

          Pattern: ^organizations/[^/]+$

          Description: Required. Resource name of the new ResourceValueConfig's parent. The parent field in the CreateResourceValueConfigRequest messages must either be empty or match this field.

          Location: path

          Required: Yes

          Type: string

      Path: v1/{+parent}/resourceValueConfigs:batchCreate

      HTTP Method: POST

      Parameter Order: parent

  • securitycenter.organizations.resourceValueConfigs.get

      HTTP Method: GET

      Parameters:

        name

          Required: Yes

          Description: Required. Name of the resource value config to retrieve. Its format is organizations/{organization}/resourceValueConfigs/{config_id}.

          Type: string

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

          Location: path

      Flat Path: v1/organizations/{organizationsId}/resourceValueConfigs/{resourceValueConfigsId}

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

      Parameter Order: name

      Path: v1/{+name}

      Description: Gets a ResourceValueConfig.

  • securitycenter.organizations.resourceValueConfigs.delete

      Parameters:

        name

          Location: path

          Type: string

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

          Required: Yes

          Description: Required. Name of the ResourceValueConfig to delete

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

      Parameter Order: name

      Flat Path: v1/organizations/{organizationsId}/resourceValueConfigs/{resourceValueConfigsId}

      Path: v1/{+name}

      Description: Deletes a ResourceValueConfig.

      HTTP Method: DELETE

  • securitycenter.organizations.resourceValueConfigs.patch

      Parameter Order: name

      Flat Path: v1/organizations/{organizationsId}/resourceValueConfigs/{resourceValueConfigsId}

      HTTP Method: PATCH

      Description: Updates an existing ResourceValueConfigs with new rules.

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

      Path: v1/{+name}

      Parameters:

        name

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

          Type: string

          Description: Name for the resource value config

          Location: path

          Required: Yes

        updateMask

          Location: query

          Format: google-fieldmask

          Type: string

          Description: The list of fields to be updated. If empty all mutable fields will be updated.

  • securitycenter.organizations.simulations.get

      HTTP Method: GET

      Parameters:

        name

          Location: path

          Description: Required. The organization name or simulation name of this simulation Valid format: "organizations/{organization}/simulations/latest" "organizations/{organization}/simulations/{simulation}"

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

          Type: string

          Required: Yes

      Path: v1/{+name}

      Flat Path: v1/organizations/{organizationsId}/simulations/{simulationsId}

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

      Description: Get the simulation by name or the latest simulation for the given organization.

      Parameter Order: name

  • securitycenter.organizations.simulations.attackPaths.list

      Flat Path: v1/organizations/{organizationsId}/simulations/{simulationsId}/attackPaths

      HTTP Method: GET

      Path: v1/{+parent}/attackPaths

      Description: Lists the attack paths for a set of simulation results or valued resources and filter.

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

      Parameters:

        pageToken

          Description: The value returned by the last `ListAttackPathsResponse`; indicates that this is a continuation of a prior `ListAttackPaths` call, and that the system should return the next page of data.

          Location: query

          Type: string

        pageSize

          Type: integer

          Format: int32

          Description: The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

          Location: query

        filter

          Type: string

          Location: query

          Description: The filter expression that filters the attack path in the response. Supported fields: * `valued_resources` supports =

        parent

          Description: Required. Name of parent to list attack paths. Valid formats: "organizations/{organization}", "organizations/{organization}/simulations/{simulation}" "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}"

          Location: path

          Required: Yes

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

          Type: string

      Parameter Order: parent

  • securitycenter.organizations.simulations.attackExposureResults.attackPaths.list

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

      Flat Path: v1/organizations/{organizationsId}/simulations/{simulationsId}/attackExposureResults/{attackExposureResultsId}/attackPaths

      HTTP Method: GET

      Path: v1/{+parent}/attackPaths

      Parameters:

        pageToken

          Description: The value returned by the last `ListAttackPathsResponse`; indicates that this is a continuation of a prior `ListAttackPaths` call, and that the system should return the next page of data.

          Type: string

          Location: query

        parent

          Pattern: ^organizations/[^/]+/simulations/[^/]+/attackExposureResults/[^/]+$

          Location: path

          Description: Required. Name of parent to list attack paths. Valid formats: "organizations/{organization}", "organizations/{organization}/simulations/{simulation}" "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}"

          Type: string

          Required: Yes

        filter

          Type: string

          Description: The filter expression that filters the attack path in the response. Supported fields: * `valued_resources` supports =

          Location: query

        pageSize

          Description: The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

          Location: query

          Format: int32

          Type: integer

      Description: Lists the attack paths for a set of simulation results or valued resources and filter.

      Parameter Order: parent

  • securitycenter.organizations.simulations.attackExposureResults.valuedResources.list

      Parameter Order: parent

      Parameters:

        filter

          Description: The filter expression that filters the valued resources in the response. Supported fields: * `resource_value` supports = * `resource_type` supports =

          Location: query

          Type: string

        pageToken

          Description: The value returned by the last `ListValuedResourcesResponse`; indicates that this is a continuation of a prior `ListValuedResources` call, and that the system should return the next page of data.

          Location: query

          Type: string

        pageSize

          Location: query

          Description: The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

          Type: integer

          Format: int32

        parent

          Location: path

          Pattern: ^organizations/[^/]+/simulations/[^/]+/attackExposureResults/[^/]+$

          Required: Yes

          Type: string

          Description: Required. Name of parent to list valued resources. Valid formats: "organizations/{organization}", "organizations/{organization}/simulations/{simulation}" "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}"

      HTTP Method: GET

      Description: Lists the valued resources for a set of simulation results and filter.

      Flat Path: v1/organizations/{organizationsId}/simulations/{simulationsId}/attackExposureResults/{attackExposureResultsId}/valuedResources

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

      Path: v1/{+parent}/valuedResources

  • securitycenter.organizations.simulations.valuedResources.attackPaths.list

      Flat Path: v1/organizations/{organizationsId}/simulations/{simulationsId}/valuedResources/{valuedResourcesId}/attackPaths

      Parameters:

        pageToken

          Description: The value returned by the last `ListAttackPathsResponse`; indicates that this is a continuation of a prior `ListAttackPaths` call, and that the system should return the next page of data.

          Location: query

          Type: string

        pageSize

          Location: query

          Format: int32

          Type: integer

          Description: The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

        filter

          Type: string

          Description: The filter expression that filters the attack path in the response. Supported fields: * `valued_resources` supports =

          Location: query

        parent

          Location: path

          Type: string

          Description: Required. Name of parent to list attack paths. Valid formats: "organizations/{organization}", "organizations/{organization}/simulations/{simulation}" "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}" "organizations/{organization}/simulations/{simulation}/valuedResources/{valued_resource}"

          Required: Yes

          Pattern: ^organizations/[^/]+/simulations/[^/]+/valuedResources/[^/]+$

      HTTP Method: GET

      Path: v1/{+parent}/attackPaths

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

      Description: Lists the attack paths for a set of simulation results or valued resources and filter.

      Parameter Order: parent

  • securitycenter.organizations.simulations.valuedResources.list

      Parameter Order: parent

      Description: Lists the valued resources for a set of simulation results and filter.

      Parameters:

        parent

          Location: path

          Required: Yes

          Type: string

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

          Description: Required. Name of parent to list valued resources. Valid formats: "organizations/{organization}", "organizations/{organization}/simulations/{simulation}" "organizations/{organization}/simulations/{simulation}/attackExposureResults/{attack_exposure_result_v2}"

        pageToken

          Type: string

          Description: The value returned by the last `ListValuedResourcesResponse`; indicates that this is a continuation of a prior `ListValuedResources` call, and that the system should return the next page of data.

          Location: query

        filter

          Location: query

          Type: string

          Description: The filter expression that filters the valued resources in the response. Supported fields: * `resource_value` supports = * `resource_type` supports =

        pageSize

          Format: int32

          Location: query

          Type: integer

          Description: The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

      Path: v1/{+parent}/valuedResources

      HTTP Method: GET

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

      Flat Path: v1/organizations/{organizationsId}/simulations/{simulationsId}/valuedResources

Deletions

    Methods
  • securitycenter.projects.eventThreatDetectionSettings.validateCustomModule

      Parameters:

        parent

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

          Type: string

          Location: path

          Description: Required. Resource name of the parent to validate the Custom Module under. Its format is: * "organizations/{organization}/eventThreatDetectionSettings". * "folders/{folder}/eventThreatDetectionSettings". * "projects/{project}/eventThreatDetectionSettings".

          Required: Yes

      Flat Path: v1/projects/{projectsId}/eventThreatDetectionSettings:validateCustomModule

      Path: v1/{+parent}:validateCustomModule

      Parameter Order: parent

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

      HTTP Method: POST

      Description: Validates the given Event Threat Detection Custom Module.

  • securitycenter.projects.eventThreatDetectionSettings.customModules.get

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

      Path: v1/{+name}

      Description: Gets an ETD custom module. Retrieves the module at the given level.

      Parameters:

        name

          Description: Required. Name of the custom module to get. Its format is: * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". * "projects/{project}/eventThreatDetectionSettings/customModules/{module}".

          Location: path

          Required: Yes

          Pattern: ^projects/[^/]+/eventThreatDetectionSettings/customModules/[^/]+$

          Type: string

      Parameter Order: name

      Flat Path: v1/projects/{projectsId}/eventThreatDetectionSettings/customModules/{customModulesId}

      HTTP Method: GET

  • securitycenter.projects.eventThreatDetectionSettings.customModules.patch

      HTTP Method: PATCH

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

      Flat Path: v1/projects/{projectsId}/eventThreatDetectionSettings/customModules/{customModulesId}

      Description: Updates an ETD custom module at the given level. All config fields can be updated when updating the module at resident level. Only enablement state can be updated when updating the module at inherited levels. Updating the module has a side-effect that it updates all descendants that are inherited from this module.

      Parameter Order: name

      Path: v1/{+name}

      Parameters:

        name

          Location: path

          Description: Immutable. The resource name of the Event Threat Detection custom module. Its format is: * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". * "projects/{project}/eventThreatDetectionSettings/customModules/{module}".

          Type: string

          Pattern: ^projects/[^/]+/eventThreatDetectionSettings/customModules/[^/]+$

          Required: Yes

        updateMask

          Type: string

          Location: query

          Format: google-fieldmask

          Description: The list of fields to be updated. If empty all mutable fields will be updated.

  • securitycenter.projects.eventThreatDetectionSettings.customModules.create

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

      HTTP Method: POST

      Parameter Order: parent

      Description: Creates an ETD custom module at the given level. Creating a module has a side-effect of creating modules at all descendants.

      Flat Path: v1/projects/{projectsId}/eventThreatDetectionSettings/customModules

      Parameters:

        parent

          Description: Required. The new custom module's parent. Its format is: * "organizations/{organization}/eventThreatDetectionSettings". * "folders/{folder}/eventThreatDetectionSettings". * "projects/{project}/eventThreatDetectionSettings".

          Type: string

          Required: Yes

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

          Location: path

      Path: v1/{+parent}/customModules

  • securitycenter.projects.eventThreatDetectionSettings.customModules.delete

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

      Parameters:

        name

          Required: Yes

          Description: Required. Name of the custom module to delete. Its format is: * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". * "projects/{project}/eventThreatDetectionSettings/customModules/{module}".

          Type: string

          Pattern: ^projects/[^/]+/eventThreatDetectionSettings/customModules/[^/]+$

          Location: path

      Flat Path: v1/projects/{projectsId}/eventThreatDetectionSettings/customModules/{customModulesId}

      Parameter Order: name

      Description: Deletes an ETD custom module. Deletion at resident level also deletes modules at all descendants. Deletion at any other level is not supported.

      Path: v1/{+name}

      HTTP Method: DELETE

  • securitycenter.projects.eventThreatDetectionSettings.customModules.list

      Path: v1/{+parent}/customModules

      HTTP Method: GET

      Parameters:

        pageToken

          Type: string

          Description: A page token, received from a previous `ListEventThreatDetectionCustomModules` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListEventThreatDetectionCustomModules` must match the call that provided the page token.

          Location: query

        pageSize

          Description: The maximum number of modules to return. The service may return fewer than this value. If unspecified, at most 10 configs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

          Location: query

          Type: integer

          Format: int32

        parent

          Type: string

          Required: Yes

          Description: Required. Name of the parent to list custom modules. Its format is: * "organizations/{organization}/eventThreatDetectionSettings". * "folders/{folder}/eventThreatDetectionSettings". * "projects/{project}/eventThreatDetectionSettings".

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

          Location: path

      Flat Path: v1/projects/{projectsId}/eventThreatDetectionSettings/customModules

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

      Description: Lists ETD custom modules. Retrieve all resident and inherited modules at the given level (no descendants).

      Parameter Order: parent

  • securitycenter.folders.eventThreatDetectionSettings.customModules.create

      Flat Path: v1/folders/{foldersId}/eventThreatDetectionSettings/customModules

      Description: Creates an ETD custom module at the given level. Creating a module has a side-effect of creating modules at all descendants.

      Parameters:

        parent

          Type: string

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

          Required: Yes

          Location: path

          Description: Required. The new custom module's parent. Its format is: * "organizations/{organization}/eventThreatDetectionSettings". * "folders/{folder}/eventThreatDetectionSettings". * "projects/{project}/eventThreatDetectionSettings".

      Parameter Order: parent

      HTTP Method: POST

      Path: v1/{+parent}/customModules

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

  • securitycenter.folders.eventThreatDetectionSettings.customModules.list

      HTTP Method: GET

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

      Flat Path: v1/folders/{foldersId}/eventThreatDetectionSettings/customModules

      Path: v1/{+parent}/customModules

      Description: Lists ETD custom modules. Retrieve all resident and inherited modules at the given level (no descendants).

      Parameter Order: parent

      Parameters:

        parent

          Description: Required. Name of the parent to list custom modules. Its format is: * "organizations/{organization}/eventThreatDetectionSettings". * "folders/{folder}/eventThreatDetectionSettings". * "projects/{project}/eventThreatDetectionSettings".

          Type: string

          Required: Yes

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

          Location: path

        pageToken

          Type: string

          Location: query

          Description: A page token, received from a previous `ListEventThreatDetectionCustomModules` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListEventThreatDetectionCustomModules` must match the call that provided the page token.

        pageSize

          Type: integer

          Location: query

          Description: The maximum number of modules to return. The service may return fewer than this value. If unspecified, at most 10 configs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

          Format: int32

  • securitycenter.folders.eventThreatDetectionSettings.customModules.get

      HTTP Method: GET

      Parameter Order: name

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

      Path: v1/{+name}

      Description: Gets an ETD custom module. Retrieves the module at the given level.

      Flat Path: v1/folders/{foldersId}/eventThreatDetectionSettings/customModules/{customModulesId}

      Parameters:

        name

          Description: Required. Name of the custom module to get. Its format is: * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". * "projects/{project}/eventThreatDetectionSettings/customModules/{module}".

          Required: Yes

          Pattern: ^folders/[^/]+/eventThreatDetectionSettings/customModules/[^/]+$

          Location: path

          Type: string

  • securitycenter.folders.eventThreatDetectionSettings.customModules.delete

      Path: v1/{+name}

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

      Parameters:

        name

          Location: path

          Description: Required. Name of the custom module to delete. Its format is: * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". * "projects/{project}/eventThreatDetectionSettings/customModules/{module}".

          Type: string

          Required: Yes

          Pattern: ^folders/[^/]+/eventThreatDetectionSettings/customModules/[^/]+$

      HTTP Method: DELETE

      Description: Deletes an ETD custom module. Deletion at resident level also deletes modules at all descendants. Deletion at any other level is not supported.

      Parameter Order: name

      Flat Path: v1/folders/{foldersId}/eventThreatDetectionSettings/customModules/{customModulesId}

  • securitycenter.folders.eventThreatDetectionSettings.customModules.patch

      HTTP Method: PATCH

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

      Flat Path: v1/folders/{foldersId}/eventThreatDetectionSettings/customModules/{customModulesId}

      Description: Updates an ETD custom module at the given level. All config fields can be updated when updating the module at resident level. Only enablement state can be updated when updating the module at inherited levels. Updating the module has a side-effect that it updates all descendants that are inherited from this module.

      Path: v1/{+name}

      Parameters:

        updateMask

          Format: google-fieldmask

          Description: The list of fields to be updated. If empty all mutable fields will be updated.

          Type: string

          Location: query

        name

          Required: Yes

          Location: path

          Description: Immutable. The resource name of the Event Threat Detection custom module. Its format is: * "organizations/{organization}/eventThreatDetectionSettings/customModules/{module}". * "folders/{folder}/eventThreatDetectionSettings/customModules/{module}". * "projects/{project}/eventThreatDetectionSettings/customModules/{module}".

          Type: string

          Pattern: ^folders/[^/]+/eventThreatDetectionSettings/customModules/[^/]+$

      Parameter Order: name

  • securitycenter.folders.eventThreatDetectionSettings.validateCustomModule

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

      Flat Path: v1/folders/{foldersId}/eventThreatDetectionSettings:validateCustomModule

      Path: v1/{+parent}:validateCustomModule

      Description: Validates the given Event Threat Detection Custom Module.

      HTTP Method: POST

      Parameter Order: parent

      Parameters:

        parent

          Location: path

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

          Description: Required. Resource name of the parent to validate the Custom Module under. Its format is: * "organizations/{organization}/eventThreatDetectionSettings". * "folders/{folder}/eventThreatDetectionSettings". * "projects/{project}/eventThreatDetectionSettings".

          Type: string

          Required: Yes