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/v2beta/{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

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

enum (ProductLine)

케이스를 요청할 제품 라인입니다. 지정하지 않으면 Google Cloud 케이스만 반환됩니다.

요청 본문

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

응답 본문

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

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