- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
Lists the most recent revisions of all Posture
resources in a specified organization and location.
HTTP request
GET https://securityposture.googleapis.com/v1/{parent=organizations/*/locations/*}/postures
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
Required. The parent resource name, in the format |
Query parameters
Parameters | |
---|---|
pageSize |
The maximum number of postures to return. The default value is If you exceed the maximum value of |
pageToken |
A pagination token returned from a previous request to list postures. Provide this token to retrieve the next page of results. |
filter |
Optional. A filter to apply to the list of postures, in the format defined in AIP-160: Filtering. |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"postures": [
{
object ( |
Fields | |
---|---|
postures[] |
The list of |
nextPageToken |
A pagination token. To retrieve the next page of results, call the method again with this token. |
unreachable[] |
Locations that were temporarily unavailable and could not be reached. |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
Requires the following IAM permission on the parent
resource:
securityposture.postures.list
For more information, see the IAM documentation.