dns

package
Version: v0.57.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 16, 2021 License: BSD-3-Clause Imports: 15 Imported by: 494

Documentation

Overview

Package dns provides access to the Cloud DNS API.

For product documentation, see: https://cloud.google.com/dns/docs

Creating a client

Usage example:

import "google.golang.org/api/dns/v1"
...
ctx := context.Background()
dnsService, err := dns.NewService(ctx)

In this example, Google Application Default Credentials are used for authentication.

For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.

Other authentication options

By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:

dnsService, err := dns.NewService(ctx, option.WithScopes(dns.NdevClouddnsReadwriteScope))

To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:

dnsService, err := dns.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:

config := &oauth2.Config{...}
// ...
token, err := config.Exchange(ctx, ...)
dnsService, err := dns.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

See https://godoc.org/google.golang.org/api/option/ for details on options.

Index

Constants

View Source
const (
	// See, edit, configure, and delete your Google Cloud data and see the
	// email address for your Google Account.
	CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"

	// View your data across Google Cloud services and see the email address
	// of your Google Account
	CloudPlatformReadOnlyScope = "https://www.googleapis.com/auth/cloud-platform.read-only"

	// View your DNS records hosted by Google Cloud DNS
	NdevClouddnsReadonlyScope = "https://www.googleapis.com/auth/ndev.clouddns.readonly"

	// View and manage your DNS records hosted by Google Cloud DNS
	NdevClouddnsReadwriteScope = "https://www.googleapis.com/auth/ndev.clouddns.readwrite"
)

OAuth2 scopes used by this API.

Variables

This section is empty.

Functions

This section is empty.

Types

type Change

type Change struct {
	// Additions: Which ResourceRecordSets to add?
	Additions []*ResourceRecordSet `json:"additions,omitempty"`

	// Deletions: Which ResourceRecordSets to remove? Must match existing
	// data exactly.
	Deletions []*ResourceRecordSet `json:"deletions,omitempty"`

	// Id: Unique identifier for the resource; defined by the server (output
	// only).
	Id string `json:"id,omitempty"`

	// IsServing: If the DNS queries for the zone will be served.
	IsServing bool `json:"isServing,omitempty"`

	Kind string `json:"kind,omitempty"`

	// StartTime: The time that this operation was started by the server
	// (output only). This is in RFC3339 text format.
	StartTime string `json:"startTime,omitempty"`

	// Status: Status of the operation (output only). A status of "done"
	// means that the request to update the authoritative servers has been
	// sent, but the servers might not be updated yet.
	//
	// Possible values:
	//   "pending"
	//   "done"
	Status string `json:"status,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Additions") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Additions") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

Change: A Change represents a set of ResourceRecordSet additions and deletions applied atomically to a ManagedZone. ResourceRecordSets within a ManagedZone are modified by creating a new Change element in the Changes collection. In turn the Changes collection also records the past modifications to the ResourceRecordSets in a ManagedZone. The current state of the ManagedZone is the sum effect of applying all Change elements in the Changes collection in sequence.

func (*Change) MarshalJSON

func (s *Change) MarshalJSON() ([]byte, error)

type ChangesCreateCall

type ChangesCreateCall struct {
	// contains filtered or unexported fields
}

func (*ChangesCreateCall) ClientOperationId

func (c *ChangesCreateCall) ClientOperationId(clientOperationId string) *ChangesCreateCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ChangesCreateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ChangesCreateCall) Do

func (c *ChangesCreateCall) Do(opts ...googleapi.CallOption) (*Change, error)

Do executes the "dns.changes.create" call. Exactly one of *Change or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Change.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ChangesCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ChangesCreateCall) Header

func (c *ChangesCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ChangesGetCall

type ChangesGetCall struct {
	// contains filtered or unexported fields
}

func (*ChangesGetCall) ClientOperationId

func (c *ChangesGetCall) ClientOperationId(clientOperationId string) *ChangesGetCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ChangesGetCall) Context

func (c *ChangesGetCall) Context(ctx context.Context) *ChangesGetCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ChangesGetCall) Do

func (c *ChangesGetCall) Do(opts ...googleapi.CallOption) (*Change, error)

Do executes the "dns.changes.get" call. Exactly one of *Change or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Change.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ChangesGetCall) Fields

func (c *ChangesGetCall) Fields(s ...googleapi.Field) *ChangesGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ChangesGetCall) Header

func (c *ChangesGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ChangesGetCall) IfNoneMatch

func (c *ChangesGetCall) IfNoneMatch(entityTag string) *ChangesGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ChangesListCall

type ChangesListCall struct {
	// contains filtered or unexported fields
}

func (*ChangesListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ChangesListCall) Do

Do executes the "dns.changes.list" call. Exactly one of *ChangesListResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ChangesListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ChangesListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ChangesListCall) Header

func (c *ChangesListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ChangesListCall) IfNoneMatch

func (c *ChangesListCall) IfNoneMatch(entityTag string) *ChangesListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ChangesListCall) MaxResults

func (c *ChangesListCall) MaxResults(maxResults int64) *ChangesListCall

MaxResults sets the optional parameter "maxResults": Maximum number of results to be returned. If unspecified, the server decides how many results to return.

func (*ChangesListCall) PageToken

func (c *ChangesListCall) PageToken(pageToken string) *ChangesListCall

PageToken sets the optional parameter "pageToken": A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.

func (*ChangesListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

func (*ChangesListCall) SortBy

func (c *ChangesListCall) SortBy(sortBy string) *ChangesListCall

SortBy sets the optional parameter "sortBy": Sorting criterion. The only supported value is change sequence.

Possible values:

"changeSequence" (default)

func (*ChangesListCall) SortOrder

func (c *ChangesListCall) SortOrder(sortOrder string) *ChangesListCall

SortOrder sets the optional parameter "sortOrder": Sorting order direction: 'ascending' or 'descending'.

type ChangesListResponse

type ChangesListResponse struct {
	// Changes: The requested changes.
	Changes []*Change `json:"changes,omitempty"`

	Header *ResponseHeader `json:"header,omitempty"`

	// Kind: Type of resource.
	Kind string `json:"kind,omitempty"`

	// NextPageToken: The presence of this field indicates that there exist
	// more results following your last page of results in pagination order.
	// To fetch them, make another list request using this value as your
	// pagination token. This lets you retrieve the complete contents of
	// even very large collections 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 cannot retrieve a "snapshot"
	// of collections larger than the maximum page size.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Changes") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Changes") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ChangesListResponse: The response to a request to enumerate Changes to a ResourceRecordSets collection.

func (*ChangesListResponse) MarshalJSON

func (s *ChangesListResponse) MarshalJSON() ([]byte, error)

type ChangesService

type ChangesService struct {
	// contains filtered or unexported fields
}

func NewChangesService

func NewChangesService(s *Service) *ChangesService

func (*ChangesService) Create

func (r *ChangesService) Create(project string, managedZone string, change *Change) *ChangesCreateCall

Create: Atomically updates the ResourceRecordSet collection.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

func (*ChangesService) Get

func (r *ChangesService) Get(project string, managedZone string, changeId string) *ChangesGetCall

Get: Fetches the representation of an existing Change.

- changeId: The identifier of the requested change, from a previous

ResourceRecordSetsChangeResponse.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

func (*ChangesService) List

func (r *ChangesService) List(project string, managedZone string) *ChangesListCall

List: Enumerates Changes to a ResourceRecordSet collection.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

type DnsKey

type DnsKey struct {
	// Algorithm: String mnemonic specifying the DNSSEC algorithm of this
	// key. Immutable after creation time.
	//
	// Possible values:
	//   "rsasha1"
	//   "rsasha256"
	//   "rsasha512"
	//   "ecdsap256sha256"
	//   "ecdsap384sha384"
	Algorithm string `json:"algorithm,omitempty"`

	// CreationTime: The time that this resource was created in the control
	// plane. This is in RFC3339 text format. Output only.
	CreationTime string `json:"creationTime,omitempty"`

	// Description: A mutable string of at most 1024 characters associated
	// with this resource for the user's convenience. Has no effect on the
	// resource's function.
	Description string `json:"description,omitempty"`

	// Digests: Cryptographic hashes of the DNSKEY resource record
	// associated with this DnsKey. These digests are needed to construct a
	// DS record that points at this DNS key. Output only.
	Digests []*DnsKeyDigest `json:"digests,omitempty"`

	// Id: Unique identifier for the resource; defined by the server (output
	// only).
	Id string `json:"id,omitempty"`

	// IsActive: Active keys are used to sign subsequent changes to the
	// ManagedZone. Inactive keys are still present as DNSKEY Resource
	// Records for the use of resolvers validating existing signatures.
	IsActive bool `json:"isActive,omitempty"`

	// KeyLength: Length of the key in bits. Specified at creation time, and
	// then immutable.
	KeyLength int64 `json:"keyLength,omitempty"`

	// KeyTag: The key tag is a non-cryptographic hash of the a DNSKEY
	// resource record associated with this DnsKey. The key tag can be used
	// to identify a DNSKEY more quickly (but it is not a unique
	// identifier). In particular, the key tag is used in a parent zone's DS
	// record to point at the DNSKEY in this child ManagedZone. The key tag
	// is a number in the range [0, 65535] and the algorithm to calculate it
	// is specified in RFC4034 Appendix B. Output only.
	KeyTag int64 `json:"keyTag,omitempty"`

	Kind string `json:"kind,omitempty"`

	// PublicKey: Base64 encoded public half of this key. Output only.
	PublicKey string `json:"publicKey,omitempty"`

	// Type: One of "KEY_SIGNING" or "ZONE_SIGNING". Keys of type
	// KEY_SIGNING have the Secure Entry Point flag set and, when active,
	// are used to sign only resource record sets of type DNSKEY. Otherwise,
	// the Secure Entry Point flag is cleared, and this key is used to sign
	// only resource record sets of other types. Immutable after creation
	// time.
	//
	// Possible values:
	//   "keySigning"
	//   "zoneSigning"
	Type string `json:"type,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Algorithm") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Algorithm") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

DnsKey: A DNSSEC key pair.

func (*DnsKey) MarshalJSON

func (s *DnsKey) MarshalJSON() ([]byte, error)

type DnsKeyDigest

type DnsKeyDigest struct {
	// Digest: The base-16 encoded bytes of this digest. Suitable for use in
	// a DS resource record.
	Digest string `json:"digest,omitempty"`

	// Type: Specifies the algorithm used to calculate this digest.
	//
	// Possible values:
	//   "sha1"
	//   "sha256"
	//   "sha384"
	Type string `json:"type,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Digest") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Digest") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*DnsKeyDigest) MarshalJSON

func (s *DnsKeyDigest) MarshalJSON() ([]byte, error)

type DnsKeySpec

type DnsKeySpec struct {
	// Algorithm: String mnemonic specifying the DNSSEC algorithm of this
	// key.
	//
	// Possible values:
	//   "rsasha1"
	//   "rsasha256"
	//   "rsasha512"
	//   "ecdsap256sha256"
	//   "ecdsap384sha384"
	Algorithm string `json:"algorithm,omitempty"`

	// KeyLength: Length of the keys in bits.
	KeyLength int64 `json:"keyLength,omitempty"`

	// KeyType: Specifies whether this is a key signing key (KSK) or a zone
	// signing key (ZSK). Key signing keys have the Secure Entry Point flag
	// set and, when active, are only used to sign resource record sets of
	// type DNSKEY. Zone signing keys do not have the Secure Entry Point
	// flag set and are used to sign all other types of resource record
	// sets.
	//
	// Possible values:
	//   "keySigning"
	//   "zoneSigning"
	KeyType string `json:"keyType,omitempty"`

	Kind string `json:"kind,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Algorithm") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Algorithm") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

DnsKeySpec: Parameters for DnsKey key generation. Used for generating initial keys for a new ManagedZone and as default when adding a new DnsKey.

func (*DnsKeySpec) MarshalJSON

func (s *DnsKeySpec) MarshalJSON() ([]byte, error)

type DnsKeysGetCall

type DnsKeysGetCall struct {
	// contains filtered or unexported fields
}

func (*DnsKeysGetCall) ClientOperationId

func (c *DnsKeysGetCall) ClientOperationId(clientOperationId string) *DnsKeysGetCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*DnsKeysGetCall) Context

func (c *DnsKeysGetCall) Context(ctx context.Context) *DnsKeysGetCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*DnsKeysGetCall) DigestType

func (c *DnsKeysGetCall) DigestType(digestType string) *DnsKeysGetCall

DigestType sets the optional parameter "digestType": An optional comma-separated list of digest types to compute and display for key signing keys. If omitted, the recommended digest type is computed and displayed.

func (*DnsKeysGetCall) Do

func (c *DnsKeysGetCall) Do(opts ...googleapi.CallOption) (*DnsKey, error)

Do executes the "dns.dnsKeys.get" call. Exactly one of *DnsKey or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *DnsKey.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*DnsKeysGetCall) Fields

func (c *DnsKeysGetCall) Fields(s ...googleapi.Field) *DnsKeysGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*DnsKeysGetCall) Header

func (c *DnsKeysGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*DnsKeysGetCall) IfNoneMatch

func (c *DnsKeysGetCall) IfNoneMatch(entityTag string) *DnsKeysGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type DnsKeysListCall

type DnsKeysListCall struct {
	// contains filtered or unexported fields
}

func (*DnsKeysListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*DnsKeysListCall) DigestType

func (c *DnsKeysListCall) DigestType(digestType string) *DnsKeysListCall

DigestType sets the optional parameter "digestType": An optional comma-separated list of digest types to compute and display for key signing keys. If omitted, the recommended digest type is computed and displayed.

func (*DnsKeysListCall) Do

Do executes the "dns.dnsKeys.list" call. Exactly one of *DnsKeysListResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *DnsKeysListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*DnsKeysListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*DnsKeysListCall) Header

func (c *DnsKeysListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*DnsKeysListCall) IfNoneMatch

func (c *DnsKeysListCall) IfNoneMatch(entityTag string) *DnsKeysListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*DnsKeysListCall) MaxResults

func (c *DnsKeysListCall) MaxResults(maxResults int64) *DnsKeysListCall

MaxResults sets the optional parameter "maxResults": Maximum number of results to be returned. If unspecified, the server decides how many results to return.

func (*DnsKeysListCall) PageToken

func (c *DnsKeysListCall) PageToken(pageToken string) *DnsKeysListCall

PageToken sets the optional parameter "pageToken": A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.

func (*DnsKeysListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type DnsKeysListResponse

type DnsKeysListResponse struct {
	// DnsKeys: The requested resources.
	DnsKeys []*DnsKey `json:"dnsKeys,omitempty"`

	Header *ResponseHeader `json:"header,omitempty"`

	// Kind: Type of resource.
	Kind string `json:"kind,omitempty"`

	// NextPageToken: The presence of this field indicates that there exist
	// more results following your last page of results in pagination order.
	// To fetch them, make another list request using this value as your
	// pagination token. In this way you can retrieve the complete contents
	// of even very large collections 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. There is no way to retrieve a
	// "snapshot" of collections larger than the maximum page size.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "DnsKeys") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "DnsKeys") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

DnsKeysListResponse: The response to a request to enumerate DnsKeys in a ManagedZone.

func (*DnsKeysListResponse) MarshalJSON

func (s *DnsKeysListResponse) MarshalJSON() ([]byte, error)

type DnsKeysService

type DnsKeysService struct {
	// contains filtered or unexported fields
}

func NewDnsKeysService

func NewDnsKeysService(s *Service) *DnsKeysService

func (*DnsKeysService) Get

func (r *DnsKeysService) Get(project string, managedZone string, dnsKeyId string) *DnsKeysGetCall

Get: Fetches the representation of an existing DnsKey.

- dnsKeyId: The identifier of the requested DnsKey. - managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

func (*DnsKeysService) List

func (r *DnsKeysService) List(project string, managedZone string) *DnsKeysListCall

List: Enumerates DnsKeys to a ResourceRecordSet collection.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

type ManagedZone

type ManagedZone struct {
	// CreationTime: The time that this resource was created on the server.
	// This is in RFC3339 text format. Output only.
	CreationTime string `json:"creationTime,omitempty"`

	// Description: A mutable string of at most 1024 characters associated
	// with this resource for the user's convenience. Has no effect on the
	// managed zone's function.
	Description string `json:"description,omitempty"`

	// DnsName: The DNS name of this managed zone, for instance
	// "example.com.".
	DnsName string `json:"dnsName,omitempty"`

	// DnssecConfig: DNSSEC configuration.
	DnssecConfig *ManagedZoneDnsSecConfig `json:"dnssecConfig,omitempty"`

	// ForwardingConfig: The presence for this field indicates that outbound
	// forwarding is enabled for this zone. The value of this field contains
	// the set of destinations to forward to.
	ForwardingConfig *ManagedZoneForwardingConfig `json:"forwardingConfig,omitempty"`

	// Id: Unique identifier for the resource; defined by the server (output
	// only)
	Id uint64 `json:"id,omitempty,string"`

	Kind string `json:"kind,omitempty"`

	// Labels: User labels.
	Labels map[string]string `json:"labels,omitempty"`

	// Name: User assigned name for this resource. Must be unique within the
	// project. The name must be 1-63 characters long, must begin with a
	// letter, end with a letter or digit, and only contain lowercase
	// letters, digits or dashes.
	Name string `json:"name,omitempty"`

	// NameServerSet: Optionally specifies the NameServerSet for this
	// ManagedZone. A NameServerSet is a set of DNS name servers that all
	// host the same ManagedZones. Most users leave this field unset. If you
	// need to use this field, contact your account team.
	NameServerSet string `json:"nameServerSet,omitempty"`

	// NameServers: Delegate your managed_zone to these virtual name
	// servers; defined by the server (output only)
	NameServers []string `json:"nameServers,omitempty"`

	// PeeringConfig: The presence of this field indicates that DNS Peering
	// is enabled for this zone. The value of this field contains the
	// network to peer with.
	PeeringConfig *ManagedZonePeeringConfig `json:"peeringConfig,omitempty"`

	// PrivateVisibilityConfig: For privately visible zones, the set of
	// Virtual Private Cloud resources that the zone is visible from.
	PrivateVisibilityConfig *ManagedZonePrivateVisibilityConfig `json:"privateVisibilityConfig,omitempty"`

	// ReverseLookupConfig: The presence of this field indicates that this
	// is a managed reverse lookup zone and Cloud DNS resolves reverse
	// lookup queries using automatically configured records for VPC
	// resources. This only applies to networks listed under
	// private_visibility_config.
	ReverseLookupConfig *ManagedZoneReverseLookupConfig `json:"reverseLookupConfig,omitempty"`

	// ServiceDirectoryConfig: This field links to the associated service
	// directory namespace. Do not set this field for public zones or
	// forwarding zones.
	ServiceDirectoryConfig *ManagedZoneServiceDirectoryConfig `json:"serviceDirectoryConfig,omitempty"`

	// Visibility: The zone's visibility: public zones are exposed to the
	// Internet, while private zones are visible only to Virtual Private
	// Cloud resources.
	//
	// Possible values:
	//   "public"
	//   "private"
	Visibility string `json:"visibility,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "CreationTime") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "CreationTime") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ManagedZone: A zone is a subtree of the DNS namespace under one administrative responsibility. A ManagedZone is a resource that represents a DNS zone hosted by the Cloud DNS service.

func (*ManagedZone) MarshalJSON

func (s *ManagedZone) MarshalJSON() ([]byte, error)

type ManagedZoneDnsSecConfig

type ManagedZoneDnsSecConfig struct {
	// DefaultKeySpecs: Specifies parameters for generating initial DnsKeys
	// for this ManagedZone. Can only be changed while the state is OFF.
	DefaultKeySpecs []*DnsKeySpec `json:"defaultKeySpecs,omitempty"`

	Kind string `json:"kind,omitempty"`

	// NonExistence: Specifies the mechanism for authenticated
	// denial-of-existence responses. Can only be changed while the state is
	// OFF.
	//
	// Possible values:
	//   "nsec"
	//   "nsec3"
	NonExistence string `json:"nonExistence,omitempty"`

	// State: Specifies whether DNSSEC is enabled, and what mode it is in.
	//
	// Possible values:
	//   "off" - DNSSEC is disabled; the zone is not signed.
	//   "on" - DNSSEC is enabled; the zone is signed and fully managed.
	//   "transfer" - DNSSEC is enabled, but in a "transfer" mode.
	State string `json:"state,omitempty"`

	// ForceSendFields is a list of field names (e.g. "DefaultKeySpecs") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "DefaultKeySpecs") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

func (*ManagedZoneDnsSecConfig) MarshalJSON

func (s *ManagedZoneDnsSecConfig) MarshalJSON() ([]byte, error)

type ManagedZoneForwardingConfig added in v0.11.0

type ManagedZoneForwardingConfig struct {
	Kind string `json:"kind,omitempty"`

	// TargetNameServers: List of target name servers to forward to. Cloud
	// DNS selects the best available name server if more than one target is
	// given.
	TargetNameServers []*ManagedZoneForwardingConfigNameServerTarget `json:"targetNameServers,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ManagedZoneForwardingConfig) MarshalJSON added in v0.11.0

func (s *ManagedZoneForwardingConfig) MarshalJSON() ([]byte, error)

type ManagedZoneForwardingConfigNameServerTarget added in v0.11.0

type ManagedZoneForwardingConfigNameServerTarget struct {
	// ForwardingPath: Forwarding path for this NameServerTarget. If unset
	// or set to DEFAULT, Cloud DNS makes forwarding decisions based on IP
	// address ranges; that is, RFC1918 addresses go to the VPC network,
	// non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud
	// DNS always sends queries through the VPC network for this target.
	//
	// Possible values:
	//   "default" - Cloud DNS makes forwarding decisions based on address
	// ranges; that is, RFC1918 addresses forward to the target through the
	// VPC and non-RFC1918 addresses forward to the target through the
	// internet
	//   "private" - Cloud DNS always forwards to this target through the
	// VPC.
	ForwardingPath string `json:"forwardingPath,omitempty"`

	// Ipv4Address: IPv4 address of a target name server.
	Ipv4Address string `json:"ipv4Address,omitempty"`

	Kind string `json:"kind,omitempty"`

	// ForceSendFields is a list of field names (e.g. "ForwardingPath") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "ForwardingPath") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

func (*ManagedZoneForwardingConfigNameServerTarget) MarshalJSON added in v0.11.0

type ManagedZoneOperationsGetCall

type ManagedZoneOperationsGetCall struct {
	// contains filtered or unexported fields
}

func (*ManagedZoneOperationsGetCall) ClientOperationId

func (c *ManagedZoneOperationsGetCall) ClientOperationId(clientOperationId string) *ManagedZoneOperationsGetCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ManagedZoneOperationsGetCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ManagedZoneOperationsGetCall) Do

Do executes the "dns.managedZoneOperations.get" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ManagedZoneOperationsGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ManagedZoneOperationsGetCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ManagedZoneOperationsGetCall) IfNoneMatch

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ManagedZoneOperationsListCall

type ManagedZoneOperationsListCall struct {
	// contains filtered or unexported fields
}

func (*ManagedZoneOperationsListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ManagedZoneOperationsListCall) Do

Do executes the "dns.managedZoneOperations.list" call. Exactly one of *ManagedZoneOperationsListResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ManagedZoneOperationsListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ManagedZoneOperationsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ManagedZoneOperationsListCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ManagedZoneOperationsListCall) IfNoneMatch

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ManagedZoneOperationsListCall) MaxResults

MaxResults sets the optional parameter "maxResults": Maximum number of results to be returned. If unspecified, the server decides how many results to return.

func (*ManagedZoneOperationsListCall) PageToken

PageToken sets the optional parameter "pageToken": A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.

func (*ManagedZoneOperationsListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

func (*ManagedZoneOperationsListCall) SortBy

SortBy sets the optional parameter "sortBy": Sorting criterion. The only supported values are START_TIME and ID.

Possible values:

"startTime" (default)
"id"

type ManagedZoneOperationsListResponse

type ManagedZoneOperationsListResponse struct {
	Header *ResponseHeader `json:"header,omitempty"`

	// Kind: Type of resource.
	Kind string `json:"kind,omitempty"`

	// NextPageToken: The presence of this field indicates that there exist
	// more results following your last page of results in pagination order.
	// To fetch them, make another list request using this value as your
	// page token. This lets you retrieve the complete contents of even very
	// large collections 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 cannot retrieve a consistent snapshot of a collection
	// larger than the maximum page size.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// Operations: The operation resources.
	Operations []*Operation `json:"operations,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Header") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Header") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ManagedZoneOperationsListResponse) MarshalJSON

func (s *ManagedZoneOperationsListResponse) MarshalJSON() ([]byte, error)

type ManagedZoneOperationsService

type ManagedZoneOperationsService struct {
	// contains filtered or unexported fields
}

func NewManagedZoneOperationsService

func NewManagedZoneOperationsService(s *Service) *ManagedZoneOperationsService

func (*ManagedZoneOperationsService) Get

func (r *ManagedZoneOperationsService) Get(project string, managedZone string, operation string) *ManagedZoneOperationsGetCall

Get: Fetches the representation of an existing Operation.

- managedZone: Identifies the managed zone addressed by this request. - operation: Identifies the operation addressed by this request (ID

of the operation).

- project: Identifies the project addressed by this request.

func (*ManagedZoneOperationsService) List

List: Enumerates Operations for the given ManagedZone.

- managedZone: Identifies the managed zone addressed by this request. - project: Identifies the project addressed by this request.

type ManagedZonePeeringConfig added in v0.16.0

type ManagedZonePeeringConfig struct {
	Kind string `json:"kind,omitempty"`

	// TargetNetwork: The network with which to peer.
	TargetNetwork *ManagedZonePeeringConfigTargetNetwork `json:"targetNetwork,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ManagedZonePeeringConfig) MarshalJSON added in v0.16.0

func (s *ManagedZonePeeringConfig) MarshalJSON() ([]byte, error)

type ManagedZonePeeringConfigTargetNetwork added in v0.16.0

type ManagedZonePeeringConfigTargetNetwork struct {
	// DeactivateTime: The time at which the zone was deactivated, in RFC
	// 3339 date-time format. An empty string indicates that the peering
	// connection is active. The producer network can deactivate a zone. The
	// zone is automatically deactivated if the producer network that the
	// zone targeted is deleted. Output only.
	DeactivateTime string `json:"deactivateTime,omitempty"`

	Kind string `json:"kind,omitempty"`

	// NetworkUrl: The fully qualified URL of the VPC network to forward
	// queries to. This should be formatted like
	// https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
	NetworkUrl string `json:"networkUrl,omitempty"`

	// ForceSendFields is a list of field names (e.g. "DeactivateTime") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "DeactivateTime") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

func (*ManagedZonePeeringConfigTargetNetwork) MarshalJSON added in v0.16.0

func (s *ManagedZonePeeringConfigTargetNetwork) MarshalJSON() ([]byte, error)

type ManagedZonePrivateVisibilityConfig added in v0.3.0

type ManagedZonePrivateVisibilityConfig struct {
	Kind string `json:"kind,omitempty"`

	// Networks: The list of VPC networks that can see this zone.
	Networks []*ManagedZonePrivateVisibilityConfigNetwork `json:"networks,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ManagedZonePrivateVisibilityConfig) MarshalJSON added in v0.3.0

func (s *ManagedZonePrivateVisibilityConfig) MarshalJSON() ([]byte, error)

type ManagedZonePrivateVisibilityConfigNetwork added in v0.3.0

type ManagedZonePrivateVisibilityConfigNetwork struct {
	Kind string `json:"kind,omitempty"`

	// NetworkUrl: The fully qualified URL of the VPC network to bind to.
	// Format this URL like
	// https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
	NetworkUrl string `json:"networkUrl,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ManagedZonePrivateVisibilityConfigNetwork) MarshalJSON added in v0.3.0

type ManagedZoneReverseLookupConfig added in v0.26.0

type ManagedZoneReverseLookupConfig struct {
	Kind string `json:"kind,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ManagedZoneReverseLookupConfig) MarshalJSON added in v0.26.0

func (s *ManagedZoneReverseLookupConfig) MarshalJSON() ([]byte, error)

type ManagedZoneServiceDirectoryConfig added in v0.37.0

type ManagedZoneServiceDirectoryConfig struct {
	Kind string `json:"kind,omitempty"`

	// Namespace: Contains information about the namespace associated with
	// the zone.
	Namespace *ManagedZoneServiceDirectoryConfigNamespace `json:"namespace,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ManagedZoneServiceDirectoryConfig: Contains information about Service Directory-backed zones.

func (*ManagedZoneServiceDirectoryConfig) MarshalJSON added in v0.37.0

func (s *ManagedZoneServiceDirectoryConfig) MarshalJSON() ([]byte, error)

type ManagedZoneServiceDirectoryConfigNamespace added in v0.37.0

type ManagedZoneServiceDirectoryConfigNamespace struct {
	// DeletionTime: The time that the namespace backing this zone was
	// deleted; an empty string if it still exists. This is in RFC3339 text
	// format. Output only.
	DeletionTime string `json:"deletionTime,omitempty"`

	Kind string `json:"kind,omitempty"`

	// NamespaceUrl: The fully qualified URL of the namespace associated
	// with the zone. Format must be
	// https://servicedirectory.googleapis.com/v1/projects/{project}/locations/{location}/namespaces/{namespace}
	NamespaceUrl string `json:"namespaceUrl,omitempty"`

	// ForceSendFields is a list of field names (e.g. "DeletionTime") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "DeletionTime") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ManagedZoneServiceDirectoryConfigNamespace) MarshalJSON added in v0.37.0

type ManagedZonesCreateCall

type ManagedZonesCreateCall struct {
	// contains filtered or unexported fields
}

func (*ManagedZonesCreateCall) ClientOperationId

func (c *ManagedZonesCreateCall) ClientOperationId(clientOperationId string) *ManagedZonesCreateCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ManagedZonesCreateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ManagedZonesCreateCall) Do

Do executes the "dns.managedZones.create" call. Exactly one of *ManagedZone or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ManagedZone.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ManagedZonesCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ManagedZonesCreateCall) Header

func (c *ManagedZonesCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ManagedZonesDeleteCall

type ManagedZonesDeleteCall struct {
	// contains filtered or unexported fields
}

func (*ManagedZonesDeleteCall) ClientOperationId

func (c *ManagedZonesDeleteCall) ClientOperationId(clientOperationId string) *ManagedZonesDeleteCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ManagedZonesDeleteCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ManagedZonesDeleteCall) Do

Do executes the "dns.managedZones.delete" call.

func (*ManagedZonesDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ManagedZonesDeleteCall) Header

func (c *ManagedZonesDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ManagedZonesGetCall

type ManagedZonesGetCall struct {
	// contains filtered or unexported fields
}

func (*ManagedZonesGetCall) ClientOperationId

func (c *ManagedZonesGetCall) ClientOperationId(clientOperationId string) *ManagedZonesGetCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ManagedZonesGetCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ManagedZonesGetCall) Do

Do executes the "dns.managedZones.get" call. Exactly one of *ManagedZone or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ManagedZone.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ManagedZonesGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ManagedZonesGetCall) Header

func (c *ManagedZonesGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ManagedZonesGetCall) IfNoneMatch

func (c *ManagedZonesGetCall) IfNoneMatch(entityTag string) *ManagedZonesGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ManagedZonesListCall

type ManagedZonesListCall struct {
	// contains filtered or unexported fields
}

func (*ManagedZonesListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ManagedZonesListCall) DnsName

func (c *ManagedZonesListCall) DnsName(dnsName string) *ManagedZonesListCall

DnsName sets the optional parameter "dnsName": Restricts the list to return only zones with this domain name.

func (*ManagedZonesListCall) Do

Do executes the "dns.managedZones.list" call. Exactly one of *ManagedZonesListResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ManagedZonesListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ManagedZonesListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ManagedZonesListCall) Header

func (c *ManagedZonesListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ManagedZonesListCall) IfNoneMatch

func (c *ManagedZonesListCall) IfNoneMatch(entityTag string) *ManagedZonesListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ManagedZonesListCall) MaxResults

func (c *ManagedZonesListCall) MaxResults(maxResults int64) *ManagedZonesListCall

MaxResults sets the optional parameter "maxResults": Maximum number of results to be returned. If unspecified, the server decides how many results to return.

func (*ManagedZonesListCall) PageToken

func (c *ManagedZonesListCall) PageToken(pageToken string) *ManagedZonesListCall

PageToken sets the optional parameter "pageToken": A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.

func (*ManagedZonesListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type ManagedZonesListResponse

type ManagedZonesListResponse struct {
	Header *ResponseHeader `json:"header,omitempty"`

	// Kind: Type of resource.
	Kind string `json:"kind,omitempty"`

	// ManagedZones: The managed zone resources.
	ManagedZones []*ManagedZone `json:"managedZones,omitempty"`

	// NextPageToken: The presence of this field indicates that there exist
	// more results following your last page of results in pagination order.
	// To fetch them, make another list request using this value as your
	// page token. This lets you the complete contents of even very large
	// collections 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 cannot retrieve a consistent snapshot of a collection
	// larger than the maximum page size.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Header") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Header") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ManagedZonesListResponse) MarshalJSON

func (s *ManagedZonesListResponse) MarshalJSON() ([]byte, error)

type ManagedZonesPatchCall

type ManagedZonesPatchCall struct {
	// contains filtered or unexported fields
}

func (*ManagedZonesPatchCall) ClientOperationId

func (c *ManagedZonesPatchCall) ClientOperationId(clientOperationId string) *ManagedZonesPatchCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ManagedZonesPatchCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ManagedZonesPatchCall) Do

Do executes the "dns.managedZones.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ManagedZonesPatchCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ManagedZonesPatchCall) Header

func (c *ManagedZonesPatchCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ManagedZonesService

type ManagedZonesService struct {
	// contains filtered or unexported fields
}

func NewManagedZonesService

func NewManagedZonesService(s *Service) *ManagedZonesService

func (*ManagedZonesService) Create

func (r *ManagedZonesService) Create(project string, managedzone *ManagedZone) *ManagedZonesCreateCall

Create: Creates a new ManagedZone.

- project: Identifies the project addressed by this request.

func (*ManagedZonesService) Delete

func (r *ManagedZonesService) Delete(project string, managedZone string) *ManagedZonesDeleteCall

Delete: Deletes a previously created ManagedZone.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

func (*ManagedZonesService) Get

func (r *ManagedZonesService) Get(project string, managedZone string) *ManagedZonesGetCall

Get: Fetches the representation of an existing ManagedZone.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

func (*ManagedZonesService) List

List: Enumerates ManagedZones that have been created but not yet deleted.

- project: Identifies the project addressed by this request.

func (*ManagedZonesService) Patch

func (r *ManagedZonesService) Patch(project string, managedZone string, managedzone *ManagedZone) *ManagedZonesPatchCall

Patch: Applies a partial update to an existing ManagedZone.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

func (*ManagedZonesService) Update

func (r *ManagedZonesService) Update(project string, managedZone string, managedzone *ManagedZone) *ManagedZonesUpdateCall

Update: Updates an existing ManagedZone.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

type ManagedZonesUpdateCall

type ManagedZonesUpdateCall struct {
	// contains filtered or unexported fields
}

func (*ManagedZonesUpdateCall) ClientOperationId

func (c *ManagedZonesUpdateCall) ClientOperationId(clientOperationId string) *ManagedZonesUpdateCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ManagedZonesUpdateCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ManagedZonesUpdateCall) Do

Do executes the "dns.managedZones.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ManagedZonesUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ManagedZonesUpdateCall) Header

func (c *ManagedZonesUpdateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type Operation

type Operation struct {
	// DnsKeyContext: Only populated if the operation targeted a DnsKey
	// (output only).
	DnsKeyContext *OperationDnsKeyContext `json:"dnsKeyContext,omitempty"`

	// Id: Unique identifier for the resource. This is the
	// client_operation_id if the client specified it when the mutation was
	// initiated, otherwise, it is generated by the server. The name must be
	// 1-63 characters long and match the regular expression [-a-z0-9]?
	// (output only)
	Id string `json:"id,omitempty"`

	Kind string `json:"kind,omitempty"`

	// StartTime: The time that this operation was started by the server.
	// This is in RFC3339 text format (output only).
	StartTime string `json:"startTime,omitempty"`

	// Status: Status of the operation. Can be one of the following:
	// "PENDING" or "DONE" (output only). A status of "DONE" means that the
	// request to update the authoritative servers has been sent, but the
	// servers might not be updated yet.
	//
	// Possible values:
	//   "pending"
	//   "done"
	Status string `json:"status,omitempty"`

	// Type: Type of the operation. Operations include insert, update, and
	// delete (output only).
	Type string `json:"type,omitempty"`

	// User: User who requested the operation, for example:
	// user@example.com. cloud-dns-system for operations automatically done
	// by the system. (output only)
	User string `json:"user,omitempty"`

	// ZoneContext: Only populated if the operation targeted a ManagedZone
	// (output only).
	ZoneContext *OperationManagedZoneContext `json:"zoneContext,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "DnsKeyContext") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "DnsKeyContext") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

Operation: An operation represents a successful mutation performed on a Cloud DNS resource. Operations provide: - An audit log of server resource mutations. - A way to recover/retry API calls in the case where the response is never received by the caller. Use the caller specified client_operation_id.

func (*Operation) MarshalJSON

func (s *Operation) MarshalJSON() ([]byte, error)

type OperationDnsKeyContext

type OperationDnsKeyContext struct {
	// NewValue: The post-operation DnsKey resource.
	NewValue *DnsKey `json:"newValue,omitempty"`

	// OldValue: The pre-operation DnsKey resource.
	OldValue *DnsKey `json:"oldValue,omitempty"`

	// ForceSendFields is a list of field names (e.g. "NewValue") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "NewValue") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*OperationDnsKeyContext) MarshalJSON

func (s *OperationDnsKeyContext) MarshalJSON() ([]byte, error)

type OperationManagedZoneContext

type OperationManagedZoneContext struct {
	// NewValue: The post-operation ManagedZone resource.
	NewValue *ManagedZone `json:"newValue,omitempty"`

	// OldValue: The pre-operation ManagedZone resource.
	OldValue *ManagedZone `json:"oldValue,omitempty"`

	// ForceSendFields is a list of field names (e.g. "NewValue") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "NewValue") to include in
	// API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*OperationManagedZoneContext) MarshalJSON

func (s *OperationManagedZoneContext) MarshalJSON() ([]byte, error)

type PoliciesCreateCall added in v0.11.0

type PoliciesCreateCall struct {
	// contains filtered or unexported fields
}

func (*PoliciesCreateCall) ClientOperationId added in v0.11.0

func (c *PoliciesCreateCall) ClientOperationId(clientOperationId string) *PoliciesCreateCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*PoliciesCreateCall) Context added in v0.11.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*PoliciesCreateCall) Do added in v0.11.0

func (c *PoliciesCreateCall) Do(opts ...googleapi.CallOption) (*Policy, error)

Do executes the "dns.policies.create" call. Exactly one of *Policy or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Policy.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*PoliciesCreateCall) Fields added in v0.11.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*PoliciesCreateCall) Header added in v0.11.0

func (c *PoliciesCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type PoliciesDeleteCall added in v0.11.0

type PoliciesDeleteCall struct {
	// contains filtered or unexported fields
}

func (*PoliciesDeleteCall) ClientOperationId added in v0.11.0

func (c *PoliciesDeleteCall) ClientOperationId(clientOperationId string) *PoliciesDeleteCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*PoliciesDeleteCall) Context added in v0.11.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*PoliciesDeleteCall) Do added in v0.11.0

Do executes the "dns.policies.delete" call.

func (*PoliciesDeleteCall) Fields added in v0.11.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*PoliciesDeleteCall) Header added in v0.11.0

func (c *PoliciesDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type PoliciesGetCall added in v0.11.0

type PoliciesGetCall struct {
	// contains filtered or unexported fields
}

func (*PoliciesGetCall) ClientOperationId added in v0.11.0

func (c *PoliciesGetCall) ClientOperationId(clientOperationId string) *PoliciesGetCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*PoliciesGetCall) Context added in v0.11.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*PoliciesGetCall) Do added in v0.11.0

func (c *PoliciesGetCall) Do(opts ...googleapi.CallOption) (*Policy, error)

Do executes the "dns.policies.get" call. Exactly one of *Policy or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Policy.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*PoliciesGetCall) Fields added in v0.11.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*PoliciesGetCall) Header added in v0.11.0

func (c *PoliciesGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*PoliciesGetCall) IfNoneMatch added in v0.11.0

func (c *PoliciesGetCall) IfNoneMatch(entityTag string) *PoliciesGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type PoliciesListCall added in v0.11.0

type PoliciesListCall struct {
	// contains filtered or unexported fields
}

func (*PoliciesListCall) Context added in v0.11.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*PoliciesListCall) Do added in v0.11.0

Do executes the "dns.policies.list" call. Exactly one of *PoliciesListResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *PoliciesListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*PoliciesListCall) Fields added in v0.11.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*PoliciesListCall) Header added in v0.11.0

func (c *PoliciesListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*PoliciesListCall) IfNoneMatch added in v0.11.0

func (c *PoliciesListCall) IfNoneMatch(entityTag string) *PoliciesListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*PoliciesListCall) MaxResults added in v0.11.0

func (c *PoliciesListCall) MaxResults(maxResults int64) *PoliciesListCall

MaxResults sets the optional parameter "maxResults": Maximum number of results to be returned. If unspecified, the server decides how many results to return.

func (*PoliciesListCall) PageToken added in v0.11.0

func (c *PoliciesListCall) PageToken(pageToken string) *PoliciesListCall

PageToken sets the optional parameter "pageToken": A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.

func (*PoliciesListCall) Pages added in v0.11.0

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type PoliciesListResponse added in v0.11.0

type PoliciesListResponse struct {
	Header *ResponseHeader `json:"header,omitempty"`

	// Kind: Type of resource.
	Kind string `json:"kind,omitempty"`

	// NextPageToken: The presence of this field indicates that there exist
	// more results following your last page of results in pagination order.
	// To fetch them, make another list request using this value as your
	// page token. This lets you the complete contents of even very large
	// collections 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 cannot retrieve a consistent snapshot of a collection
	// larger than the maximum page size.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// Policies: The policy resources.
	Policies []*Policy `json:"policies,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Header") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Header") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*PoliciesListResponse) MarshalJSON added in v0.11.0

func (s *PoliciesListResponse) MarshalJSON() ([]byte, error)

type PoliciesPatchCall added in v0.11.0

type PoliciesPatchCall struct {
	// contains filtered or unexported fields
}

func (*PoliciesPatchCall) ClientOperationId added in v0.11.0

func (c *PoliciesPatchCall) ClientOperationId(clientOperationId string) *PoliciesPatchCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*PoliciesPatchCall) Context added in v0.11.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*PoliciesPatchCall) Do added in v0.11.0

Do executes the "dns.policies.patch" call. Exactly one of *PoliciesPatchResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *PoliciesPatchResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*PoliciesPatchCall) Fields added in v0.11.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*PoliciesPatchCall) Header added in v0.11.0

func (c *PoliciesPatchCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type PoliciesPatchResponse added in v0.11.0

type PoliciesPatchResponse struct {
	Header *ResponseHeader `json:"header,omitempty"`

	Policy *Policy `json:"policy,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Header") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Header") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*PoliciesPatchResponse) MarshalJSON added in v0.11.0

func (s *PoliciesPatchResponse) MarshalJSON() ([]byte, error)

type PoliciesService added in v0.11.0

type PoliciesService struct {
	// contains filtered or unexported fields
}

func NewPoliciesService added in v0.11.0

func NewPoliciesService(s *Service) *PoliciesService

func (*PoliciesService) Create added in v0.11.0

func (r *PoliciesService) Create(project string, policy *Policy) *PoliciesCreateCall

Create: Creates a new Policy.

- project: Identifies the project addressed by this request.

func (*PoliciesService) Delete added in v0.11.0

func (r *PoliciesService) Delete(project string, policy string) *PoliciesDeleteCall

Delete: Deletes a previously created Policy. Fails if the policy is still being referenced by a network.

- policy: User given friendly name of the policy addressed by this

request.

- project: Identifies the project addressed by this request.

func (*PoliciesService) Get added in v0.11.0

func (r *PoliciesService) Get(project string, policy string) *PoliciesGetCall

Get: Fetches the representation of an existing Policy.

- policy: User given friendly name of the policy addressed by this

request.

- project: Identifies the project addressed by this request.

func (*PoliciesService) List added in v0.11.0

func (r *PoliciesService) List(project string) *PoliciesListCall

List: Enumerates all Policies associated with a project.

- project: Identifies the project addressed by this request.

func (*PoliciesService) Patch added in v0.11.0

func (r *PoliciesService) Patch(project string, policy string, policy2 *Policy) *PoliciesPatchCall

Patch: Applies a partial update to an existing Policy.

- policy: User given friendly name of the policy addressed by this

request.

- project: Identifies the project addressed by this request.

func (*PoliciesService) Update added in v0.11.0

func (r *PoliciesService) Update(project string, policy string, policy2 *Policy) *PoliciesUpdateCall

Update: Updates an existing Policy.

- policy: User given friendly name of the policy addressed by this

request.

- project: Identifies the project addressed by this request.

type PoliciesUpdateCall added in v0.11.0

type PoliciesUpdateCall struct {
	// contains filtered or unexported fields
}

func (*PoliciesUpdateCall) ClientOperationId added in v0.11.0

func (c *PoliciesUpdateCall) ClientOperationId(clientOperationId string) *PoliciesUpdateCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*PoliciesUpdateCall) Context added in v0.11.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*PoliciesUpdateCall) Do added in v0.11.0

Do executes the "dns.policies.update" call. Exactly one of *PoliciesUpdateResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *PoliciesUpdateResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*PoliciesUpdateCall) Fields added in v0.11.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*PoliciesUpdateCall) Header added in v0.11.0

func (c *PoliciesUpdateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type PoliciesUpdateResponse added in v0.11.0

type PoliciesUpdateResponse struct {
	Header *ResponseHeader `json:"header,omitempty"`

	Policy *Policy `json:"policy,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Header") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Header") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*PoliciesUpdateResponse) MarshalJSON added in v0.11.0

func (s *PoliciesUpdateResponse) MarshalJSON() ([]byte, error)

type Policy added in v0.11.0

type Policy struct {
	// AlternativeNameServerConfig: Sets an alternative name server for the
	// associated networks. When specified, all DNS queries are forwarded to
	// a name server that you choose. Names such as .internal are not
	// available when an alternative name server is specified.
	AlternativeNameServerConfig *PolicyAlternativeNameServerConfig `json:"alternativeNameServerConfig,omitempty"`

	// Description: A mutable string of at most 1024 characters associated
	// with this resource for the user's convenience. Has no effect on the
	// policy's function.
	Description string `json:"description,omitempty"`

	// EnableInboundForwarding: Allows networks bound to this policy to
	// receive DNS queries sent by VMs or applications over VPN connections.
	// When enabled, a virtual IP address is allocated from each of the
	// subnetworks that are bound to this policy.
	EnableInboundForwarding bool `json:"enableInboundForwarding,omitempty"`

	// EnableLogging: Controls whether logging is enabled for the networks
	// bound to this policy. Defaults to no logging if not set.
	EnableLogging bool `json:"enableLogging,omitempty"`

	// Id: Unique identifier for the resource; defined by the server (output
	// only).
	Id uint64 `json:"id,omitempty,string"`

	Kind string `json:"kind,omitempty"`

	// Name: User-assigned name for this policy.
	Name string `json:"name,omitempty"`

	// Networks: List of network names specifying networks to which this
	// policy is applied.
	Networks []*PolicyNetwork `json:"networks,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g.
	// "AlternativeNameServerConfig") to unconditionally include in API
	// requests. By default, fields with empty or default values are omitted
	// from API requests. However, any non-pointer, non-interface field
	// appearing in ForceSendFields will be sent to the server regardless of
	// whether the field is empty or not. This may be used to include empty
	// fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g.
	// "AlternativeNameServerConfig") to include in API requests with the
	// JSON null value. By default, fields with empty values are omitted
	// from API requests. However, any field with an empty value appearing
	// in NullFields will be sent to the server as null. It is an error if a
	// field in this list has a non-empty value. This may be used to include
	// null fields in Patch requests.
	NullFields []string `json:"-"`
}

Policy: A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.

func (*Policy) MarshalJSON added in v0.11.0

func (s *Policy) MarshalJSON() ([]byte, error)

type PolicyAlternativeNameServerConfig added in v0.11.0

type PolicyAlternativeNameServerConfig struct {
	Kind string `json:"kind,omitempty"`

	// TargetNameServers: Sets an alternative name server for the associated
	// networks. When specified, all DNS queries are forwarded to a name
	// server that you choose. Names such as .internal are not available
	// when an alternative name server is specified.
	TargetNameServers []*PolicyAlternativeNameServerConfigTargetNameServer `json:"targetNameServers,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*PolicyAlternativeNameServerConfig) MarshalJSON added in v0.11.0

func (s *PolicyAlternativeNameServerConfig) MarshalJSON() ([]byte, error)

type PolicyAlternativeNameServerConfigTargetNameServer added in v0.11.0

type PolicyAlternativeNameServerConfigTargetNameServer struct {
	// ForwardingPath: Forwarding path for this TargetNameServer. If unset
	// or set to DEFAULT, Cloud DNS makes forwarding decisions based on
	// address ranges; that is, RFC1918 addresses go to the VPC network,
	// non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud
	// DNS always sends queries through the VPC network for this target.
	//
	// Possible values:
	//   "default" - Cloud DNS makes forwarding decision based on IP address
	// ranges; that is, RFC1918 addresses forward to the target through the
	// VPC and non-RFC1918 addresses forward to the target through the
	// internet
	//   "private" - Cloud DNS always forwards to this target through the
	// VPC.
	ForwardingPath string `json:"forwardingPath,omitempty"`

	// Ipv4Address: IPv4 address to forward to.
	Ipv4Address string `json:"ipv4Address,omitempty"`

	Kind string `json:"kind,omitempty"`

	// ForceSendFields is a list of field names (e.g. "ForwardingPath") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "ForwardingPath") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

func (*PolicyAlternativeNameServerConfigTargetNameServer) MarshalJSON added in v0.11.0

type PolicyNetwork added in v0.11.0

type PolicyNetwork struct {
	Kind string `json:"kind,omitempty"`

	// NetworkUrl: The fully qualified URL of the VPC network to bind to.
	// This should be formatted like
	// https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
	NetworkUrl string `json:"networkUrl,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*PolicyNetwork) MarshalJSON added in v0.11.0

func (s *PolicyNetwork) MarshalJSON() ([]byte, error)

type Project

type Project struct {
	// Id: User assigned unique identifier for the resource (output only).
	Id string `json:"id,omitempty"`

	Kind string `json:"kind,omitempty"`

	// Number: Unique numeric identifier for the resource; defined by the
	// server (output only).
	Number uint64 `json:"number,omitempty,string"`

	// Quota: Quotas assigned to this project (output only).
	Quota *Quota `json:"quota,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Id") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Id") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

Project: A project resource. The project is a top level container for resources including Cloud DNS ManagedZones. Projects can be created only in the APIs console. Next tag: 7.

func (*Project) MarshalJSON

func (s *Project) MarshalJSON() ([]byte, error)

type ProjectsGetCall

type ProjectsGetCall struct {
	// contains filtered or unexported fields
}

func (*ProjectsGetCall) ClientOperationId

func (c *ProjectsGetCall) ClientOperationId(clientOperationId string) *ProjectsGetCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ProjectsGetCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsGetCall) Do

func (c *ProjectsGetCall) Do(opts ...googleapi.CallOption) (*Project, error)

Do executes the "dns.projects.get" call. Exactly one of *Project or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Project.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsGetCall) Header

func (c *ProjectsGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsGetCall) IfNoneMatch

func (c *ProjectsGetCall) IfNoneMatch(entityTag string) *ProjectsGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ProjectsService

type ProjectsService struct {
	// contains filtered or unexported fields
}

func NewProjectsService

func NewProjectsService(s *Service) *ProjectsService

func (*ProjectsService) Get

func (r *ProjectsService) Get(project string) *ProjectsGetCall

Get: Fetches the representation of an existing Project.

- project: Identifies the project addressed by this request.

type Quota

type Quota struct {
	// DnsKeysPerManagedZone: Maximum allowed number of DnsKeys per
	// ManagedZone.
	DnsKeysPerManagedZone int64 `json:"dnsKeysPerManagedZone,omitempty"`

	Kind string `json:"kind,omitempty"`

	// ManagedZones: Maximum allowed number of managed zones in the project.
	ManagedZones int64 `json:"managedZones,omitempty"`

	// ManagedZonesPerNetwork: Maximum allowed number of managed zones which
	// can be attached to a network.
	ManagedZonesPerNetwork int64 `json:"managedZonesPerNetwork,omitempty"`

	// NetworksPerManagedZone: Maximum allowed number of networks to which a
	// privately scoped zone can be attached.
	NetworksPerManagedZone int64 `json:"networksPerManagedZone,omitempty"`

	// NetworksPerPolicy: Maximum allowed number of networks per policy.
	NetworksPerPolicy int64 `json:"networksPerPolicy,omitempty"`

	// Policies: Maximum allowed number of policies per project.
	Policies int64 `json:"policies,omitempty"`

	// ResourceRecordsPerRrset: Maximum allowed number of ResourceRecords
	// per ResourceRecordSet.
	ResourceRecordsPerRrset int64 `json:"resourceRecordsPerRrset,omitempty"`

	// RrsetAdditionsPerChange: Maximum allowed number of ResourceRecordSets
	// to add per ChangesCreateRequest.
	RrsetAdditionsPerChange int64 `json:"rrsetAdditionsPerChange,omitempty"`

	// RrsetDeletionsPerChange: Maximum allowed number of ResourceRecordSets
	// to delete per ChangesCreateRequest.
	RrsetDeletionsPerChange int64 `json:"rrsetDeletionsPerChange,omitempty"`

	// RrsetsPerManagedZone: Maximum allowed number of ResourceRecordSets
	// per zone in the project.
	RrsetsPerManagedZone int64 `json:"rrsetsPerManagedZone,omitempty"`

	// TargetNameServersPerManagedZone: Maximum allowed number of target
	// name servers per managed forwarding zone.
	TargetNameServersPerManagedZone int64 `json:"targetNameServersPerManagedZone,omitempty"`

	// TargetNameServersPerPolicy: Maximum allowed number of alternative
	// target name servers per policy.
	TargetNameServersPerPolicy int64 `json:"targetNameServersPerPolicy,omitempty"`

	// TotalRrdataSizePerChange: Maximum allowed size for total rrdata in
	// one ChangesCreateRequest in bytes.
	TotalRrdataSizePerChange int64 `json:"totalRrdataSizePerChange,omitempty"`

	// WhitelistedKeySpecs: DNSSEC algorithm and key length types that can
	// be used for DnsKeys.
	WhitelistedKeySpecs []*DnsKeySpec `json:"whitelistedKeySpecs,omitempty"`

	// ForceSendFields is a list of field names (e.g.
	// "DnsKeysPerManagedZone") to unconditionally include in API requests.
	// By default, fields with empty or default values are omitted from API
	// requests. However, any non-pointer, non-interface field appearing in
	// ForceSendFields will be sent to the server regardless of whether the
	// field is empty or not. This may be used to include empty fields in
	// Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "DnsKeysPerManagedZone") to
	// include in API requests with the JSON null value. By default, fields
	// with empty values are omitted from API requests. However, any field
	// with an empty value appearing in NullFields will be sent to the
	// server as null. It is an error if a field in this list has a
	// non-empty value. This may be used to include null fields in Patch
	// requests.
	NullFields []string `json:"-"`
}

Quota: Limits associated with a Project.

func (*Quota) MarshalJSON

func (s *Quota) MarshalJSON() ([]byte, error)

type ResourceRecordSet

type ResourceRecordSet struct {
	Kind string `json:"kind,omitempty"`

	// Name: For example, www.example.com.
	Name string `json:"name,omitempty"`

	// Rrdatas: As defined in RFC 1035 (section 5) and RFC 1034 (section
	// 3.6.1) -- see examples.
	Rrdatas []string `json:"rrdatas,omitempty"`

	// SignatureRrdatas: As defined in RFC 4034 (section 3.2).
	SignatureRrdatas []string `json:"signatureRrdatas,omitempty"`

	// Ttl: Number of seconds that this ResourceRecordSet can be cached by
	// resolvers.
	Ttl int64 `json:"ttl,omitempty"`

	// Type: The identifier of a supported record type. See the list of
	// Supported DNS record types.
	Type string `json:"type,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Kind") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Kind") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ResourceRecordSet: A unit of data that is returned by the DNS servers.

func (*ResourceRecordSet) MarshalJSON

func (s *ResourceRecordSet) MarshalJSON() ([]byte, error)

type ResourceRecordSetsCreateCall added in v0.51.0

type ResourceRecordSetsCreateCall struct {
	// contains filtered or unexported fields
}

func (*ResourceRecordSetsCreateCall) ClientOperationId added in v0.51.0

func (c *ResourceRecordSetsCreateCall) ClientOperationId(clientOperationId string) *ResourceRecordSetsCreateCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ResourceRecordSetsCreateCall) Context added in v0.51.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ResourceRecordSetsCreateCall) Do added in v0.51.0

Do executes the "dns.resourceRecordSets.create" call. Exactly one of *ResourceRecordSet or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ResourceRecordSet.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ResourceRecordSetsCreateCall) Fields added in v0.51.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ResourceRecordSetsCreateCall) Header added in v0.51.0

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ResourceRecordSetsDeleteCall added in v0.51.0

type ResourceRecordSetsDeleteCall struct {
	// contains filtered or unexported fields
}

func (*ResourceRecordSetsDeleteCall) ClientOperationId added in v0.51.0

func (c *ResourceRecordSetsDeleteCall) ClientOperationId(clientOperationId string) *ResourceRecordSetsDeleteCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ResourceRecordSetsDeleteCall) Context added in v0.51.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ResourceRecordSetsDeleteCall) Do added in v0.51.0

Do executes the "dns.resourceRecordSets.delete" call. Exactly one of *ResourceRecordSetsDeleteResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ResourceRecordSetsDeleteResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ResourceRecordSetsDeleteCall) Fields added in v0.51.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ResourceRecordSetsDeleteCall) Header added in v0.51.0

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ResourceRecordSetsDeleteResponse added in v0.41.0

type ResourceRecordSetsDeleteResponse struct {
	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`
}

type ResourceRecordSetsGetCall added in v0.51.0

type ResourceRecordSetsGetCall struct {
	// contains filtered or unexported fields
}

func (*ResourceRecordSetsGetCall) ClientOperationId added in v0.51.0

func (c *ResourceRecordSetsGetCall) ClientOperationId(clientOperationId string) *ResourceRecordSetsGetCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ResourceRecordSetsGetCall) Context added in v0.51.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ResourceRecordSetsGetCall) Do added in v0.51.0

Do executes the "dns.resourceRecordSets.get" call. Exactly one of *ResourceRecordSet or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ResourceRecordSet.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ResourceRecordSetsGetCall) Fields added in v0.51.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ResourceRecordSetsGetCall) Header added in v0.51.0

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ResourceRecordSetsGetCall) IfNoneMatch added in v0.51.0

func (c *ResourceRecordSetsGetCall) IfNoneMatch(entityTag string) *ResourceRecordSetsGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ResourceRecordSetsListCall

type ResourceRecordSetsListCall struct {
	// contains filtered or unexported fields
}

func (*ResourceRecordSetsListCall) Context

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ResourceRecordSetsListCall) Do

Do executes the "dns.resourceRecordSets.list" call. Exactly one of *ResourceRecordSetsListResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ResourceRecordSetsListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ResourceRecordSetsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ResourceRecordSetsListCall) Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ResourceRecordSetsListCall) IfNoneMatch

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ResourceRecordSetsListCall) MaxResults

func (c *ResourceRecordSetsListCall) MaxResults(maxResults int64) *ResourceRecordSetsListCall

MaxResults sets the optional parameter "maxResults": Maximum number of results to be returned. If unspecified, the server decides how many results to return.

func (*ResourceRecordSetsListCall) Name

Name sets the optional parameter "name": Restricts the list to return only records with this fully qualified domain name.

func (*ResourceRecordSetsListCall) PageToken

PageToken sets the optional parameter "pageToken": A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.

func (*ResourceRecordSetsListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

func (*ResourceRecordSetsListCall) Type

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

type ResourceRecordSetsListResponse

type ResourceRecordSetsListResponse struct {
	Header *ResponseHeader `json:"header,omitempty"`

	// Kind: Type of resource.
	Kind string `json:"kind,omitempty"`

	// NextPageToken: The presence of this field indicates that there exist
	// more results following your last page of results in pagination order.
	// To fetch them, make another list request using this value as your
	// pagination token. This lets you retrieve complete contents of even
	// larger collections, one page at a time. However, if the contents of
	// the collection change between the first and last paginated list
	// request, the set of elements returned are an inconsistent view of the
	// collection. You cannot retrieve a consistent snapshot of a collection
	// larger than the maximum page size.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// Rrsets: The resource record set resources.
	Rrsets []*ResourceRecordSet `json:"rrsets,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the
	// server.
	googleapi.ServerResponse `json:"-"`

	// ForceSendFields is a list of field names (e.g. "Header") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "Header") to include in API
	// requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. However, any field with an
	// empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

func (*ResourceRecordSetsListResponse) MarshalJSON

func (s *ResourceRecordSetsListResponse) MarshalJSON() ([]byte, error)

type ResourceRecordSetsPatchCall added in v0.51.0

type ResourceRecordSetsPatchCall struct {
	// contains filtered or unexported fields
}

func (*ResourceRecordSetsPatchCall) ClientOperationId added in v0.51.0

func (c *ResourceRecordSetsPatchCall) ClientOperationId(clientOperationId string) *ResourceRecordSetsPatchCall

ClientOperationId sets the optional parameter "clientOperationId": For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

func (*ResourceRecordSetsPatchCall) Context added in v0.51.0

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ResourceRecordSetsPatchCall) Do added in v0.51.0

Do executes the "dns.resourceRecordSets.patch" call. Exactly one of *ResourceRecordSet or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ResourceRecordSet.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ResourceRecordSetsPatchCall) Fields added in v0.51.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ResourceRecordSetsPatchCall) Header added in v0.51.0

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ResourceRecordSetsService

type ResourceRecordSetsService struct {
	// contains filtered or unexported fields
}

func NewResourceRecordSetsService

func NewResourceRecordSetsService(s *Service) *ResourceRecordSetsService

func (*ResourceRecordSetsService) Create added in v0.51.0

func (r *ResourceRecordSetsService) Create(project string, managedZone string, resourcerecordset *ResourceRecordSet) *ResourceRecordSetsCreateCall

Create: Creates a new ResourceRecordSet.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

func (*ResourceRecordSetsService) Delete added in v0.51.0

func (r *ResourceRecordSetsService) Delete(project string, managedZone string, name string, type_ string) *ResourceRecordSetsDeleteCall

Delete: Deletes a previously created ResourceRecordSet.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- name: Fully qualified domain name. - project: Identifies the project addressed by this request. - type: RRSet type.

func (*ResourceRecordSetsService) Get added in v0.51.0

func (r *ResourceRecordSetsService) Get(project string, managedZone string, name string, type_ string) *ResourceRecordSetsGetCall

Get: Fetches the representation of an existing ResourceRecordSet.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- name: Fully qualified domain name. - project: Identifies the project addressed by this request. - type: RRSet type.

func (*ResourceRecordSetsService) List

func (r *ResourceRecordSetsService) List(project string, managedZone string) *ResourceRecordSetsListCall

List: Enumerates ResourceRecordSets that you have created but not yet deleted.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- project: Identifies the project addressed by this request.

func (*ResourceRecordSetsService) Patch added in v0.51.0

func (r *ResourceRecordSetsService) Patch(project string, managedZone string, name string, type_ string, resourcerecordset *ResourceRecordSet) *ResourceRecordSetsPatchCall

Patch: Applies a partial update to an existing ResourceRecordSet.

- managedZone: Identifies the managed zone addressed by this request.

Can be the managed zone name or ID.

- name: Fully qualified domain name. - project: Identifies the project addressed by this request. - type: RRSet type.

type ResponseHeader

type ResponseHeader struct {
	// OperationId: For mutating operation requests that completed
	// successfully. This is the client_operation_id if the client specified
	// it, otherwise it is generated by the server (output only).
	OperationId string `json:"operationId,omitempty"`

	// ForceSendFields is a list of field names (e.g. "OperationId") to
	// unconditionally include in API requests. By default, fields with
	// empty or default values are omitted from API requests. However, any
	// non-pointer, non-interface field appearing in ForceSendFields will be
	// sent to the server regardless of whether the field is empty or not.
	// This may be used to include empty fields in Patch requests.
	ForceSendFields []string `json:"-"`

	// NullFields is a list of field names (e.g. "OperationId") to include
	// in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. However, any field with
	// an empty value appearing in NullFields will be sent to the server as
	// null. It is an error if a field in this list has a non-empty value.
	// This may be used to include null fields in Patch requests.
	NullFields []string `json:"-"`
}

ResponseHeader: Elements common to every response.

func (*ResponseHeader) MarshalJSON

func (s *ResponseHeader) MarshalJSON() ([]byte, error)

type Service

type Service struct {
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	Changes *ChangesService

	DnsKeys *DnsKeysService

	ManagedZoneOperations *ManagedZoneOperationsService

	ManagedZones *ManagedZonesService

	Policies *PoliciesService

	Projects *ProjectsService

	ResourceRecordSets *ResourceRecordSetsService
	// contains filtered or unexported fields
}

func New deprecated

This function has been deprecated.
func New(client *http.Client) (*Service, error)

New creates a new Service. It uses the provided http.Client for requests.

Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.

func NewService added in v0.3.0

func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)

NewService creates a new Service.

Source Files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL