Method: cases.list

상위 요소 아래의 모든 케이스를 검색하되, 하위 요소는 검색하지 않습니다.

예를 들어 조직의 케이스를 나열하면 해당 조직의 직접적인 상위 케이스만 반환됩니다. 조직 및 프로젝트에서 케이스를 검색하려면 cases.search를 사용합니다.

예:

cURL:

parent="projects/some-project"
curl \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://cloudsupport.googleapis.com/v2/$parent/cases"

Python

import googleapiclient.discovery

apiVersion = "v2"
supportApiService = googleapiclient.discovery.build(
    serviceName="cloudsupport",
    version=apiVersion,
    discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={apiVersion}",
)

request =
  supportApiService.cases().list(parent="projects/some-project")
print(request.execute())

HTTP 요청

GET https://cloudsupport.googleapis.com/v2/{parent=*/*}/cases

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 케이스를 나열할 상위 요소의 이름입니다.

쿼리 매개변수

매개변수
filter

string

케이스를 필터링하는 데 사용되는 표현식입니다.

빈 문자열인 경우 필터링이 수행되지 않습니다. 그렇지 않으면 엔드포인트가 필터와 일치하는 케이스를 반환합니다.

표현식에는 AND로 구분되고 =가 지정된 다음 필드가 사용됩니다.

  • state: OPEN 또는 CLOSED일 수 있습니다.
  • priority: P0, P1, P2, P3 또는 P4일 수 있습니다. OR 연산자를 사용하여 우선순위에 여러 값을 지정할 수 있습니다. 예를 들면 priority=P1 OR priority=P2입니다.
  • creator.email: 케이스 생성자의 이메일 주소입니다.

예:

  • state=CLOSED
  • state=OPEN AND creator.email="tester@example.com"
  • state=OPEN AND (priority=P0 OR priority=P1)
pageSize

integer

요청별로 가져올 수 있는 최대 케이스 수입니다. 기본값은 10입니다.
pageToken

string

반환할 결과 페이지를 식별하는 토큰입니다. 지정하지 않으면 첫 번째 페이지가 검색됩니다.

요청 본문

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

응답 본문

cases.list 엔드포인트의 응답 메시지입니다.

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

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

object (Case)

필터가 적용된 후 상위 요소와 연결된 케이스의 목록입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰입니다. 이후 cases.list 요청의 pageToken 필드에 이를 설정합니다. 지정하지 않으면 더 이상 검색할 결과가 없습니다.

승인 범위

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

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

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