Method: organizations.locations.postures.list

지정된 조직 및 위치의 모든 Posture 리소스의 최신 버전을 나열합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 입력란입니다. organizations/{organization}/locations/global 형식의 상위 리소스 이름입니다.

쿼리 매개변수

매개변수
pageSize

integer

반환할 최대 자세 수입니다. 기본값은 500입니다.

최대 값 1000을 초과하면 서비스에서 최대 값을 사용합니다.

pageToken

string

이전에 자세를 나열하기 위해 요청한 결과 반환된 페이지로 나누기 토큰입니다. 결과의 다음 페이지를 가져오려면 이 토큰을 제공합니다.

filter

string

선택사항입니다. AIP-160: 필터링에 정의된 형식의 자세 목록에 적용할 필터입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "postures": [
    {
      object (Posture)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
필드
postures[]

object (Posture)

Posture 리소스 목록입니다.

nextPageToken

string

페이지로 나누기 토큰입니다. 결과의 다음 페이지를 검색하려면 이 토큰을 사용하여 메서드를 다시 호출합니다.

unreachable[]

string

일시적으로 사용할 수 없거나 도달할 수 없는 위치입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • securityposture.postures.list

자세한 내용은 IAM 문서를 참조하세요.