Method: cases.list

Recuperar todos os casos de um pai, mas não dos filhos dele.

Por exemplo, listar os casos em uma organização retorna apenas os casos que são controlados diretamente por ela. Para recuperar casos em uma organização e nos projetos dela, use cases.search.

EXEMPLOS:

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())

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome de um familiar responsável em que os casos serão listados.

Parâmetros de consulta

Parâmetros
filter

string

Uma expressão usada para filtrar casos.

Se for uma string vazia, não há filtragem. Caso contrário, o endpoint retornará os casos que correspondem ao filtro.

As expressões usam os seguintes campos separados por AND e especificados com =:

  • state: pode ser OPEN ou CLOSED.
  • priority: pode ser P0, P1, P2, P3 ou P4. É possível especificar diversos valores para prioridade usando o operador OR. Exemplo: priority=P1 OR priority=P2.
  • creator.email: o endereço de e-mail do criador do caso.

EXEMPLOS:

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

integer

O número máximo de casos buscados com cada solicitação. O valor padrão é 10.
pageToken

string

Um token que identifica a página de resultados a serem retornados. Se não for especificado, a primeira página será recuperada.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

A mensagem de resposta para o endpoint case.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "cases": [
    {
      object (Case)
    }
  ],
  "nextPageToken": string
}
Campos
cases[]

object (Case)

A lista de casos associados ao pai após a aplicação de todos os filtros.
nextPageToken

string

Um token para recuperar a próxima página de resultados. Defina isso no campo pageToken das solicitações cases.list subsequentes. Se não for especificado, não haverá mais resultados para recuperar.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.