Package dns
Overview ▹
Index ▹
Constants
OAuth2 scopes used by this API.
const ( // View and manage your data across Google Cloud Platform services CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" // View your data across Google Cloud Platform services 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" )
type Change ¶
Change: An atomic update to a collection of ResourceRecordSets.
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: Identifies what kind of resource this is. Value: the fixed // string "dns#change". 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). // // Possible values: // "DONE" // "PENDING" 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 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:"-"` }
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 ¶
func (c *ChangesCreateCall) Context(ctx context.Context) *ChangesCreateCall
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 ¶
func (c *ChangesCreateCall) Fields(s ...googleapi.Field) *ChangesCreateCall
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 ¶
func (c *ChangesListCall) Context(ctx context.Context) *ChangesListCall
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 ¶
func (c *ChangesListCall) Do(opts ...googleapi.CallOption) (*ChangesListResponse, error)
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 ¶
func (c *ChangesListCall) Fields(s ...googleapi.Field) *ChangesListCall
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 will decide 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 ¶
func (c *ChangesListCall) Pages(ctx context.Context, f func(*ChangesListResponse) error) error
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:
"CHANGE_SEQUENCE" (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 ¶
ChangesListResponse: The response to a request to enumerate Changes to a ResourceRecordSets collection.
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. // // 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 will be 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. "Changes") to // unconditionally include in API requests. By default, fields with // empty 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:"-"` }
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 update the ResourceRecordSet collection.
func (*ChangesService) Get ¶
func (r *ChangesService) Get(project string, managedZone string, changeId string) *ChangesGetCall
Get: Fetch the representation of an existing Change.
func (*ChangesService) List ¶
func (r *ChangesService) List(project string, managedZone string) *ChangesListCall
List: Enumerate Changes to a ResourceRecordSet collection.
type DnsKey ¶
DnsKey: A DNSSEC key pair.
type DnsKey struct { // Algorithm: String mnemonic specifying the DNSSEC algorithm of this // key. Immutable after creation time. // // Possible values: // "ECDSAP256SHA256" // "ECDSAP384SHA384" // "RSASHA1" // "RSASHA256" // "RSASHA512" 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 will be used to sign subsequent changes to the // ManagedZone. Inactive keys will still be 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 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: Identifies what kind of resource this is. Value: the fixed // string "dns#dnsKey". 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, // will be used to sign only resource record sets of type DNSKEY. // Otherwise, the Secure Entry Point flag will be cleared and this key // will be used to sign only resource record sets of other types. // Immutable after creation time. // // Possible values: // "KEY_SIGNING" // "ZONE_SIGNING" 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 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:"-"` }
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 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 ¶
DnsKeySpec: Parameters for DnsKey key generation. Used for generating initial keys for a new ManagedZone and as default when adding a new DnsKey.
type DnsKeySpec struct { // Algorithm: String mnemonic specifying the DNSSEC algorithm of this // key. // // Possible values: // "ECDSAP256SHA256" // "ECDSAP384SHA384" // "RSASHA1" // "RSASHA256" // "RSASHA512" Algorithm string `json:"algorithm,omitempty"` // KeyLength: Length of the keys in bits. KeyLength int64 `json:"keyLength,omitempty"` // KeyType: One of "KEY_SIGNING" or "ZONE_SIGNING". Keys of type // KEY_SIGNING have the Secure Entry Point flag set and, when active, // will be used to sign only resource record sets of type DNSKEY. // Otherwise, the Secure Entry Point flag will be cleared and this key // will be used to sign only resource record sets of other types. // // Possible values: // "KEY_SIGNING" // "ZONE_SIGNING" KeyType string `json:"keyType,omitempty"` // Kind: Identifies what kind of resource this is. Value: the fixed // string "dns#dnsKeySpec". 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 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:"-"` }
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 will be 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 ¶
func (c *DnsKeysListCall) Context(ctx context.Context) *DnsKeysListCall
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 will be computed and displayed.
func (*DnsKeysListCall) Do ¶
func (c *DnsKeysListCall) Do(opts ...googleapi.CallOption) (*DnsKeysListResponse, error)
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 ¶
func (c *DnsKeysListCall) Fields(s ...googleapi.Field) *DnsKeysListCall
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 will decide 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 ¶
func (c *DnsKeysListCall) Pages(ctx context.Context, f func(*DnsKeysListResponse) error) error
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 ¶
DnsKeysListResponse: The response to a request to enumerate DnsKeys in a ManagedZone.
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 will be 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 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:"-"` }
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: Fetch the representation of an existing DnsKey.
func (*DnsKeysService) List ¶
func (r *DnsKeysService) List(project string, managedZone string) *DnsKeysListCall
List: Enumerate DnsKeys to a ResourceRecordSet collection.
type ManagedZone ¶
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.
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"` // Id: Unique identifier for the resource; defined by the server (output // only) Id uint64 `json:"id,omitempty,string"` // Kind: Identifies what kind of resource this is. Value: the fixed // string "dns#managedZone". Kind string `json:"kind,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 will leave this field unset. 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"` // 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 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:"-"` }
func (*ManagedZone) MarshalJSON ¶
func (s *ManagedZone) MarshalJSON() ([]byte, error)
type ManagedZoneDnsSecConfig ¶
type ManagedZoneDnsSecConfig struct { // DefaultKeySpecs: Specifies parameters that will be used for // generating initial DnsKeys for this ManagedZone. Output only while // state is not OFF. DefaultKeySpecs []*DnsKeySpec `json:"defaultKeySpecs,omitempty"` // Kind: Identifies what kind of resource this is. Value: the fixed // string "dns#managedZoneDnsSecConfig". Kind string `json:"kind,omitempty"` // NonExistence: Specifies the mechanism used to provide authenticated // denial-of-existence responses. Output only while state is not 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" // "ON" // "TRANSFER" 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 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 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 ¶
func (c *ManagedZoneOperationsGetCall) Context(ctx context.Context) *ManagedZoneOperationsGetCall
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 ¶
func (c *ManagedZoneOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
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 ¶
func (c *ManagedZoneOperationsGetCall) Fields(s ...googleapi.Field) *ManagedZoneOperationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ManagedZoneOperationsGetCall) Header ¶
func (c *ManagedZoneOperationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ManagedZoneOperationsGetCall) IfNoneMatch ¶
func (c *ManagedZoneOperationsGetCall) IfNoneMatch(entityTag string) *ManagedZoneOperationsGetCall
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 ¶
func (c *ManagedZoneOperationsListCall) Context(ctx context.Context) *ManagedZoneOperationsListCall
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 ¶
func (c *ManagedZoneOperationsListCall) Do(opts ...googleapi.CallOption) (*ManagedZoneOperationsListResponse, error)
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 ¶
func (c *ManagedZoneOperationsListCall) Fields(s ...googleapi.Field) *ManagedZoneOperationsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ManagedZoneOperationsListCall) Header ¶
func (c *ManagedZoneOperationsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ManagedZoneOperationsListCall) IfNoneMatch ¶
func (c *ManagedZoneOperationsListCall) IfNoneMatch(entityTag string) *ManagedZoneOperationsListCall
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 ¶
func (c *ManagedZoneOperationsListCall) MaxResults(maxResults int64) *ManagedZoneOperationsListCall
MaxResults sets the optional parameter "maxResults": Maximum number of results to be returned. If unspecified, the server will decide how many results to return.
func (*ManagedZoneOperationsListCall) PageToken ¶
func (c *ManagedZoneOperationsListCall) PageToken(pageToken string) *ManagedZoneOperationsListCall
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 ¶
func (c *ManagedZoneOperationsListCall) Pages(ctx context.Context, f func(*ManagedZoneOperationsListResponse) error) error
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 ¶
func (c *ManagedZoneOperationsListCall) SortBy(sortBy string) *ManagedZoneOperationsListCall
SortBy sets the optional parameter "sortBy": Sorting criterion. The only supported values are START_TIME and ID.
Possible values:
"ID" "START_TIME" (default)
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. // // 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 will be an inconsistent view of the // collection. There is no way to 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 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: Fetch the representation of an existing Operation.
func (*ManagedZoneOperationsService) List ¶
func (r *ManagedZoneOperationsService) List(project string, managedZone string) *ManagedZoneOperationsListCall
List: Enumerate Operations for the given ManagedZone.
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 ¶
func (c *ManagedZonesCreateCall) Context(ctx context.Context) *ManagedZonesCreateCall
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 ¶
func (c *ManagedZonesCreateCall) Do(opts ...googleapi.CallOption) (*ManagedZone, error)
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 ¶
func (c *ManagedZonesCreateCall) Fields(s ...googleapi.Field) *ManagedZonesCreateCall
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 ¶
func (c *ManagedZonesDeleteCall) Context(ctx context.Context) *ManagedZonesDeleteCall
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 ¶
func (c *ManagedZonesDeleteCall) Do(opts ...googleapi.CallOption) (*ManagedZonesDeleteResponse, error)
Do executes the "dns.managedZones.delete" call. Exactly one of *ManagedZonesDeleteResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ManagedZonesDeleteResponse.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 (*ManagedZonesDeleteCall) Fields ¶
func (c *ManagedZonesDeleteCall) Fields(s ...googleapi.Field) *ManagedZonesDeleteCall
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 ManagedZonesDeleteResponse ¶
type ManagedZonesDeleteResponse struct { Header *ResponseHeader `json:"header,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 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 (*ManagedZonesDeleteResponse) MarshalJSON ¶
func (s *ManagedZonesDeleteResponse) MarshalJSON() ([]byte, error)
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 ¶
func (c *ManagedZonesGetCall) Context(ctx context.Context) *ManagedZonesGetCall
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 ¶
func (c *ManagedZonesGetCall) Do(opts ...googleapi.CallOption) (*ManagedZone, error)
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 ¶
func (c *ManagedZonesGetCall) Fields(s ...googleapi.Field) *ManagedZonesGetCall
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 ¶
func (c *ManagedZonesListCall) Context(ctx context.Context) *ManagedZonesListCall
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 ¶
func (c *ManagedZonesListCall) Do(opts ...googleapi.CallOption) (*ManagedZonesListResponse, error)
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 ¶
func (c *ManagedZonesListCall) Fields(s ...googleapi.Field) *ManagedZonesListCall
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 will decide 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 ¶
func (c *ManagedZonesListCall) Pages(ctx context.Context, f func(*ManagedZonesListResponse) error) error
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. // // 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 will be an inconsistent view of the // collection. There is no way to 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 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 ¶
func (c *ManagedZonesPatchCall) Context(ctx context.Context) *ManagedZonesPatchCall
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 ¶
func (c *ManagedZonesPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
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 ¶
func (c *ManagedZonesPatchCall) Fields(s ...googleapi.Field) *ManagedZonesPatchCall
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: Create a new ManagedZone.
func (*ManagedZonesService) Delete ¶
func (r *ManagedZonesService) Delete(project string, managedZone string) *ManagedZonesDeleteCall
Delete: Delete a previously created ManagedZone.
func (*ManagedZonesService) Get ¶
func (r *ManagedZonesService) Get(project string, managedZone string) *ManagedZonesGetCall
Get: Fetch the representation of an existing ManagedZone.
func (*ManagedZonesService) List ¶
func (r *ManagedZonesService) List(project string) *ManagedZonesListCall
List: Enumerate ManagedZones that have been created but not yet deleted.
func (*ManagedZonesService) Patch ¶
func (r *ManagedZonesService) Patch(project string, managedZone string, managedzone *ManagedZone) *ManagedZonesPatchCall
Patch: Update an existing ManagedZone. This method supports patch semantics.
func (*ManagedZonesService) Update ¶
func (r *ManagedZonesService) Update(project string, managedZone string, managedzone *ManagedZone) *ManagedZonesUpdateCall
Update: Update an existing ManagedZone.
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 ¶
func (c *ManagedZonesUpdateCall) Context(ctx context.Context) *ManagedZonesUpdateCall
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 ¶
func (c *ManagedZonesUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
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 ¶
func (c *ManagedZonesUpdateCall) Fields(s ...googleapi.Field) *ManagedZonesUpdateCall
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 ¶
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.
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: Identifies what kind of resource this is. Value: the fixed // string "dns#operation". 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). // // Possible values: // "DONE" // "PENDING" 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 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:"-"` }
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 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 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 Project ¶
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.
type Project struct { // Id: User assigned unique identifier for the resource (output only). Id string `json:"id,omitempty"` // Kind: Identifies what kind of resource this is. Value: the fixed // string "dns#project". 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 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:"-"` }
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 ¶
func (c *ProjectsGetCall) Context(ctx context.Context) *ProjectsGetCall
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 ¶
func (c *ProjectsGetCall) Fields(s ...googleapi.Field) *ProjectsGetCall
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: Fetch the representation of an existing Project.
type Quota ¶
Quota: Limits associated with a Project.
type Quota struct { // DnsKeysPerManagedZone: Maximum allowed number of DnsKeys per // ManagedZone. DnsKeysPerManagedZone int64 `json:"dnsKeysPerManagedZone,omitempty"` // Kind: Identifies what kind of resource this is. Value: the fixed // string "dns#quota". Kind string `json:"kind,omitempty"` // ManagedZones: Maximum allowed number of managed zones in the project. ManagedZones int64 `json:"managedZones,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"` // 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 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:"-"` }
func (*Quota) MarshalJSON ¶
func (s *Quota) MarshalJSON() ([]byte, error)
type ResourceRecordSet ¶
ResourceRecordSet: A unit of data that will be returned by the DNS servers.
type ResourceRecordSet struct { // Kind: Identifies what kind of resource this is. Value: the fixed // string "dns#resourceRecordSet". 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). 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, for example, A, // AAAA, MX, TXT, and so on. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Kind") to // unconditionally include in API requests. By default, fields with // empty 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 (*ResourceRecordSet) MarshalJSON ¶
func (s *ResourceRecordSet) MarshalJSON() ([]byte, error)
type ResourceRecordSetsListCall ¶
type ResourceRecordSetsListCall struct {
// contains filtered or unexported fields
}
func (*ResourceRecordSetsListCall) Context ¶
func (c *ResourceRecordSetsListCall) Context(ctx context.Context) *ResourceRecordSetsListCall
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 ¶
func (c *ResourceRecordSetsListCall) Do(opts ...googleapi.CallOption) (*ResourceRecordSetsListResponse, error)
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 ¶
func (c *ResourceRecordSetsListCall) Fields(s ...googleapi.Field) *ResourceRecordSetsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ResourceRecordSetsListCall) Header ¶
func (c *ResourceRecordSetsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ResourceRecordSetsListCall) IfNoneMatch ¶
func (c *ResourceRecordSetsListCall) IfNoneMatch(entityTag string) *ResourceRecordSetsListCall
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 will decide how many results to return.
func (*ResourceRecordSetsListCall) Name ¶
func (c *ResourceRecordSetsListCall) Name(name string) *ResourceRecordSetsListCall
Name sets the optional parameter "name": Restricts the list to return only records with this fully qualified domain name.
func (*ResourceRecordSetsListCall) PageToken ¶
func (c *ResourceRecordSetsListCall) PageToken(pageToken string) *ResourceRecordSetsListCall
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 ¶
func (c *ResourceRecordSetsListCall) Pages(ctx context.Context, f func(*ResourceRecordSetsListResponse) error) error
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 ¶
func (c *ResourceRecordSetsListCall) Type(type_ string) *ResourceRecordSetsListCall
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. // // 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 will be an inconsistent view of the // collection. There is no way to 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 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 ResourceRecordSetsService ¶
type ResourceRecordSetsService struct {
// contains filtered or unexported fields
}
func NewResourceRecordSetsService ¶
func NewResourceRecordSetsService(s *Service) *ResourceRecordSetsService
func (*ResourceRecordSetsService) List ¶
func (r *ResourceRecordSetsService) List(project string, managedZone string) *ResourceRecordSetsListCall
List: Enumerate ResourceRecordSets that have been created but not yet deleted.
type ResponseHeader ¶
ResponseHeader: Elements common to every response.
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 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:"-"` }
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 Projects *ProjectsService ResourceRecordSets *ResourceRecordSetsService // contains filtered or unexported fields }
func New ¶
func New(client *http.Client) (*Service, error)