Method: projects.locations.backupCollections.list

Lista todas as coleções de backup de um projeto do consumidor no local especificado (região) ou em todos os locais.

Se locationId for especificado como - (caractere curinga), todas as regiões disponíveis para o projeto serão consultadas e os resultados serão agregados.

Solicitação HTTP

GET https://memorystore.googleapis.com/v1beta/{parent=projects/*/locations/*}/backupCollections

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso do local de backupCollection usando o formulário: projects/{projectId}/locations/{locationId}, em que locationId se refere a uma região do Google Cloud.

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de itens para retornar.

Caso não seja especificado, um valor padrão de 1000 será usado pelo serviço. Seja qual for o valor de pageSize, a resposta pode incluir uma lista parcial, e o autor da chamada precisa confiar apenas no nextPageToken da resposta para determinar se há mais clusters a serem consultados.

pageToken

string

Opcional. O valor nextPageToken retornado de uma solicitação [backupCollections.list] anterior, se houver.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para [backupCollections.list].

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

Representação JSON
{
  "backupCollections": [
    {
      object (BackupCollection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
backupCollections[]

object (BackupCollection)

Uma lista de backupCollections no projeto.

Se o locationId no campo pai da solicitação for "-", todas as regiões disponíveis para o projeto serão consultadas e os resultados, agregados. Se um local não estiver disponível em uma consulta agregada, uma entrada de backupCollection de marcador de posição será incluída na resposta com o campo name definido como um valor do formulário projects/{projectId}/locations/{locationId}/backupCollections/- e o campo status definido como ERROR e o campo statusMessage definido como "local não disponível para backupCollections.list".

nextPageToken

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.

unreachable[]

string

Locais que não puderam ser alcançados.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • memorystore.backupCollections.list

Para mais informações, consulte a documentação do IAM.