Method: projects.configs.variables.list

제공된 필터와 일치하는 지정된 구성 내의 변수를 나열합니다. returnValues가 true인 경우를 제외하고는 값이 아닌 변수 이름만 나열됩니다. 이 경우 사용자가 variables.get에 대한 IAM 권한이 있는 변수만 반환됩니다.

HTTP 요청

GET https://runtimeconfig.googleapis.com/v1beta1/{parent=projects/*/configs/*}/variables

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

경로 매개변수

매개변수
parent

string

변수를 나열할 RuntimeConfig 리소스의 경로입니다. 구성이 사전에 있어야 합니다. 경로는 다음 형식이어야 합니다.

projects/[PROJECT_ID]/configs/[CONFIG_NAME]

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 Google IAM 권한이 필요합니다.

  • runtimeconfig.variables.list

쿼리 매개변수

매개변수
filter

string

지정된 필터와 일치하는 변수를 필터링합니다. 예를 들면 다음과 같습니다.

projects/example-project/config/[CONFIG_NAME]/variables/example-variable.
pageSize

number

페이지당 반환할 결과 수를 지정합니다. 요소가 지정된 수보다 적으면 모든 요소를 반환합니다.

pageToken

string

사용할 페이지 토큰을 지정합니다. pageToken를 이전 목록 요청에서 반환된 nextPageToken로 설정하여 결과의 다음 페이지를 가져옵니다.

returnValues

boolean

이 플래그는 사용자가 변수 값을 반환할지 여부를 나타냅니다. true인 경우 사용자에게 IAM variables.get 권한이 있는 변수만 값과 함께 반환됩니다.

요청 본문

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

응답 본문

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

variables.list() 메서드에 대한 응답입니다.

JSON 표현 
{
  "variables": [
    {
      object(Variable)
    }
  ],
  "nextPageToken": string
}
필드
variables[]

object(Variable)

변수 및 값의 목록입니다. 반환된 변수 객체의 순서는 임의입니다.

nextPageToken

string

이 토큰을 사용하면 목록 요청의 결과 페이지를 다음으로 가져올 수 있습니다. 결과 수가 pageSize보다 크면 다음 목록 요청에서 쿼리 매개변수 pageToken의 값으로 nextPageToken를 사용합니다. 후속 목록 요청에는 결과를 계속 탐색할 수 있는 자체 nextPageToken가 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

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

사용해 보기