Mudanças: lista

Enumerar alterações em uma coleção ResourceRecordSet.

Solicitação

Solicitação HTTP

GET https://dns.googleapis.com/dns/v1beta2/projects/project/managedZones/managedZone/changes

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
managedZone string Identifica a zona gerenciada abordada por essa solicitação. Pode ser o nome ou o ID da zona gerenciada.
project string Identifica o projeto abordado por essa solicitação.
Parâmetros de consulta opcionais
maxResults integer Opcional. Número máximo de resultados a serem retornados. Se não for especificado, o servidor decidirá quantos resultados retornar.
pageToken string Opcional. Uma tag retornada por uma solicitação de lista anterior que foi truncada. Use esse parâmetro para continuar uma solicitação de lista anterior.
sortBy string Critérios de classificação. O único valor compatível é a sequência de alterações.

Os valores aceitáveis são:
  • "changeSequence" (padrão)
sortOrder string Direção da ordem de classificação: "crescente" ou "decrescente".

autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos:

escopo
https://www.googleapis.com/auth/ndev.clouddns.readonly
https://www.googleapis.com/auth/ndev.clouddns.readwrite
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-platform.read-only

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se bem-sucedido, este método retornará um corpo de resposta com a seguinte estrutura:

{
  "kind": "dns#changesListResponse",
  "header": {
    "operationId": string
  },
  "changes": [
    changes Resource
  ],
  "nextPageToken": string
}
Nome da propriedade Valor Descrição Observações
kind string Tipo de recurso.
changes[] list As alterações solicitadas.
nextPageToken string A presença desse campo indica que existem mais resultados após sua última página de resultados na ordem de paginação. Para buscá-los, faça outra solicitação de lista usando esse valor como o token de paginação.

Dessa forma, é possível recuperar o conteúdo completo até mesmo de coleções muito grandes, uma página por vez. No entanto, se o conteúdo da coleção for alterado entre a primeira e a última solicitação de lista paginada, o conjunto de todos os elementos retornados será uma visualização inconsistente da coleção. Não há como recuperar um "instantâneo" de coleções maiores que o tamanho máximo da página.
header.operationId string Para solicitações de operação de mutação concluídas com sucesso. Este é o client_operation_id se o cliente o especificou. Caso contrário, ele é gerado pelo servidor (somente saída).