Method: resourceRecordSets.list

Enumerates ResourceRecordSets that you have created but not yet deleted.

HTTP request

GET https://dns.googleapis.com/dns/v1/projects/{project}/managedZones/{managedZone}/rrsets

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
project

string

Identifies the project addressed by this request.

managedZone

string

Identifies the managed zone addressed by this request. Can be the managed zone name or ID.

Query parameters

Parameters
maxResults

integer

Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.

pageToken

string

Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.

name

string

Restricts the list to return only records with this fully qualified domain name.

type

string

Restricts the list to return only records of this type. If present, the "name" parameter must also be present.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation
{
  "rrsets": [
    {
      object (ResourceRecordSet)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Fields
rrsets[]

object (ResourceRecordSet)

The resource record set resources.

nextPageToken

string

This field indicates that more results are available beyond the last page displayed. To fetch the results, make another list request and use this value as your page token. This lets you retrieve the complete contents of a very large collection one page at a time.

However, if the contents of the collection change between the first and last paginated list request, the set of all elements returned are an inconsistent view of the collection. You can't retrieve a consistent snapshot of a collection larger than the maximum page size.

kind

string

Type of resource.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.