Documentation ¶
Overview ¶
Package dns provides access to the Google Cloud DNS API.
See https://developers.google.com/cloud-dns
Usage example:
import "google.golang.org/api/dns/v1beta1" ... dnsService, err := dns.New(oauthHttpClient)
Index ¶
- Constants
- type Change
- type ChangesCreateCall
- type ChangesGetCall
- type ChangesListCall
- func (c *ChangesListCall) Context(ctx context.Context) *ChangesListCall
- func (c *ChangesListCall) Do(opts ...googleapi.CallOption) (*ChangesListResponse, error)
- func (c *ChangesListCall) Fields(s ...googleapi.Field) *ChangesListCall
- func (c *ChangesListCall) IfNoneMatch(entityTag string) *ChangesListCall
- func (c *ChangesListCall) MaxResults(maxResults int64) *ChangesListCall
- func (c *ChangesListCall) PageToken(pageToken string) *ChangesListCall
- func (c *ChangesListCall) Pages(ctx context.Context, f func(*ChangesListResponse) error) error
- func (c *ChangesListCall) SortBy(sortBy string) *ChangesListCall
- func (c *ChangesListCall) SortOrder(sortOrder string) *ChangesListCall
- type ChangesListResponse
- type ChangesService
- type ManagedZone
- type ManagedZonesCreateCall
- type ManagedZonesDeleteCall
- type ManagedZonesGetCall
- func (c *ManagedZonesGetCall) Context(ctx context.Context) *ManagedZonesGetCall
- func (c *ManagedZonesGetCall) Do(opts ...googleapi.CallOption) (*ManagedZone, error)
- func (c *ManagedZonesGetCall) Fields(s ...googleapi.Field) *ManagedZonesGetCall
- func (c *ManagedZonesGetCall) IfNoneMatch(entityTag string) *ManagedZonesGetCall
- type ManagedZonesListCall
- func (c *ManagedZonesListCall) Context(ctx context.Context) *ManagedZonesListCall
- func (c *ManagedZonesListCall) DnsName(dnsName string) *ManagedZonesListCall
- func (c *ManagedZonesListCall) Do(opts ...googleapi.CallOption) (*ManagedZonesListResponse, error)
- func (c *ManagedZonesListCall) Fields(s ...googleapi.Field) *ManagedZonesListCall
- func (c *ManagedZonesListCall) IfNoneMatch(entityTag string) *ManagedZonesListCall
- func (c *ManagedZonesListCall) MaxResults(maxResults int64) *ManagedZonesListCall
- func (c *ManagedZonesListCall) PageToken(pageToken string) *ManagedZonesListCall
- func (c *ManagedZonesListCall) Pages(ctx context.Context, f func(*ManagedZonesListResponse) error) error
- type ManagedZonesListResponse
- type ManagedZonesService
- func (r *ManagedZonesService) Create(project string, managedzone *ManagedZone) *ManagedZonesCreateCall
- func (r *ManagedZonesService) Delete(project string, managedZone string) *ManagedZonesDeleteCall
- func (r *ManagedZonesService) Get(project string, managedZone string) *ManagedZonesGetCall
- func (r *ManagedZonesService) List(project string) *ManagedZonesListCall
- type Project
- type ProjectsGetCall
- type ProjectsService
- type Quota
- type ResourceRecordSet
- type ResourceRecordSetsListCall
- func (c *ResourceRecordSetsListCall) Context(ctx context.Context) *ResourceRecordSetsListCall
- func (c *ResourceRecordSetsListCall) Do(opts ...googleapi.CallOption) (*ResourceRecordSetsListResponse, error)
- func (c *ResourceRecordSetsListCall) Fields(s ...googleapi.Field) *ResourceRecordSetsListCall
- func (c *ResourceRecordSetsListCall) IfNoneMatch(entityTag string) *ResourceRecordSetsListCall
- func (c *ResourceRecordSetsListCall) MaxResults(maxResults int64) *ResourceRecordSetsListCall
- func (c *ResourceRecordSetsListCall) Name(name string) *ResourceRecordSetsListCall
- func (c *ResourceRecordSetsListCall) PageToken(pageToken string) *ResourceRecordSetsListCall
- func (c *ResourceRecordSetsListCall) Pages(ctx context.Context, f func(*ResourceRecordSetsListResponse) error) error
- func (c *ResourceRecordSetsListCall) Type(type_ string) *ResourceRecordSetsListCall
- type ResourceRecordSetsListResponse
- type ResourceRecordSetsService
- type Service
Constants ¶
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" )
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"` // 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. // This is in RFC3339 text format. StartTime string `json:"startTime,omitempty"` // Status: Status of the operation (output only). 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:"-"` }
Change: An atomic update to a collection of ResourceRecordSets.
func (*Change) MarshalJSON ¶
type ChangesCreateCall ¶
type ChangesCreateCall struct {
// contains filtered or unexported fields
}
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.
type ChangesGetCall ¶
type ChangesGetCall struct {
// contains filtered or unexported fields
}
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) 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) 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:
"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"` // 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:"-"` }
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 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 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"` // 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-32 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:"-"` }
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 ManagedZonesCreateCall ¶
type ManagedZonesCreateCall struct {
// contains filtered or unexported fields
}
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.
type ManagedZonesDeleteCall ¶
type ManagedZonesDeleteCall struct {
// contains filtered or unexported fields
}
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) error
Do executes the "dns.managedZones.delete" call.
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.
type ManagedZonesGetCall ¶
type ManagedZonesGetCall struct {
// contains filtered or unexported fields
}
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) 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) 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 { // 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. "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 (*ManagedZonesListResponse) MarshalJSON ¶
func (s *ManagedZonesListResponse) MarshalJSON() ([]byte, error)
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.
type Project ¶
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:"-"` }
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.
func (*Project) MarshalJSON ¶
type ProjectsGetCall ¶
type ProjectsGetCall struct {
// contains filtered or unexported fields
}
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) 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 ¶
type Quota struct { // 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"` // 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:"-"` }
Quota: Limits associated with a Project.
func (*Quota) MarshalJSON ¶
type ResourceRecordSet ¶
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"` // 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:"-"` }
ResourceRecordSet: A unit of data that will be returned by the DNS servers.
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) 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 { // 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. "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 (*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 Service ¶
type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment Changes *ChangesService ManagedZones *ManagedZonesService Projects *ProjectsService ResourceRecordSets *ResourceRecordSetsService // contains filtered or unexported fields }