Security Posture API

Defines, assesses, and monitors the overall status of your security in Google Cloud. You can use security postures to evaluate your current cloud security against defined benchmarks and help maintain the level of security that your organization requires.

Service: securityposture.googleapis.com

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://securityposture.googleapis.com

REST Resource: v1.organizations.locations.operations

Methods
cancel POST /v1/{name=organizations/*/locations/*/operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=organizations/*/locations/*/operations/**}
Deletes a long-running operation.
get GET /v1/{name=organizations/*/locations/*/operations/*}
Gets the latest state of a long-running operation.
list GET /v1/{name=organizations/*/locations/*/operations}
Lists operations that match the specified filter in the request.

REST Resource: v1.organizations.locations.postureDeployments

Methods
create POST /v1/{parent=organizations/*/locations/*}/postureDeployments
Creates a new PostureDeployment in a given project and location.
delete DELETE /v1/{name=organizations/*/locations/*/postureDeployments/*}
Deletes a PostureDeployment.
get GET /v1/{name=organizations/*/locations/*/postureDeployments/*}
Gets details for a PostureDeployment.
list GET /v1/{parent=organizations/*/locations/*}/postureDeployments
Lists every PostureDeployment in a project and location.
patch PATCH /v1/{postureDeployment.name=organizations/*/locations/*/postureDeployments/*}
Updates an existing PostureDeployment.

REST Resource: v1.organizations.locations.postureTemplates

Methods
get GET /v1/{name=organizations/*/locations/*/postureTemplates/*}
Gets a single revision of a PostureTemplate.
list GET /v1/{parent=organizations/*/locations/*}/postureTemplates
Lists every PostureTemplate in a given organization and location.

REST Resource: v1.organizations.locations.postures

Methods
create POST /v1/{parent=organizations/*/locations/*}/postures
Creates a new Posture.
delete DELETE /v1/{name=organizations/*/locations/*/postures/*}
Deletes all revisions of a Posture.
extract POST /v1/{parent=organizations/*/locations/*}/postures:extract
Extracts existing policies from an organization, folder, or project, and applies them to another organization, folder, or project as a Posture.
get GET /v1/{name=organizations/*/locations/*/postures/*}
Gets a single revision of a Posture.
list GET /v1/{parent=organizations/*/locations/*}/postures
Lists the most recent revisions of all Posture resources in a specified organization and location.
listRevisions GET /v1/{name=organizations/*/locations/*/postures/*}:listRevisions
Lists all revisions of a single Posture.
patch PATCH /v1/{posture.name=organizations/*/locations/*/postures/*}
Updates a revision of an existing Posture.

REST Resource: v1.organizations.locations.reports

Methods
createIaCValidationReport POST /v1/{parent=organizations/*/locations/*}/reports:createIaCValidationReport
Validates a specified infrastructure-as-code (IaC) configuration, and creates a Report with the validation results.
get GET /v1/{name=organizations/*/locations/*/reports/*}
Gets details for a Report.
list GET /v1/{parent=organizations/*/locations/*}/reports
Lists every Report in a given organization and location.