Package dns

import "google.golang.org/api/dns/v1"
...
dnsService, err := dns.New(oauthHttpClient)

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"`

    // 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) 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) 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:

"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 ¶

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"`

    // 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 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"`

    // 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 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.

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) 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.

func (*ManagedZonesDeleteCall) Header ¶

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

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

type ManagedZonesGetCall ¶

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

func (*ManagedZonesGetCall) 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 {
    // 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 ¶

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) 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 {
    // 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:"-"`
}

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"`

    // 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 {
    // 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
}

func New ¶

func New(client *http.Client) (*Service, error)