Method: organizations.locations.postures.list

Muestra las revisiones más recientes de todos los recursos Posture en una organización y una ubicación especificadas.

Solicitud HTTP

GET https://securityposture.googleapis.com/v1/{parent=organizations/*/locations/*}/postures

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el nombre del recurso superior, en el formato organizations/{organization}/locations/global.

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de posturas que se mostrarán. El valor predeterminado es 500.

Si superas el valor máximo de 1000, el servicio usará el valor máximo.

pageToken

string

Un token de paginación que se muestra de una solicitud anterior para enumerar las posturas Proporciona este token para recuperar la siguiente página de resultados.

filter

string

Opcional. Es un filtro que se aplica a la lista de posturas, en el formato definido en AIP-160: Filtering.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "postures": [
    {
      object (Posture)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
postures[]

object (Posture)

La lista de recursos Posture.

nextPageToken

string

Un token de paginación Para recuperar la siguiente página de resultados, vuelve a llamar al método con este token.

unreachable[]

string

Ubicaciones que no estaban disponibles temporalmente y a las que no se pudo acceder.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • securityposture.postures.list

Para obtener más información, consulta la documentación de IAM.