Reference documentation and code samples for the Cloud DNS API module Google::Cloud::Dns.
Google Cloud DNS
Google Cloud DNS is a high-performance, resilient, global DNS service that provides a cost-effective way to make your applications and services available to your users. This programmable, authoritative DNS service can be used to easily publish and manage DNS records using the same infrastructure relied upon by Google. To learn more, read What is Google Cloud DNS?.
Methods
.configure
def self.configure() -> Google::Cloud::Config
Configure the Google Cloud DNS library.
The following DNS configuration parameters are supported:
project_id
- (String) Identifier for a DNS project. (The parameterproject
is considered deprecated, but may also be used.)credentials
- (String, Hash, Google::Auth::Credentials) The path to the keyfile as a String, the contents of the keyfile as a Hash, or a Google::Auth::Credentials object. (See Credentials) (The parameterkeyfile
is considered deprecated, but may also be used.)scope
- (String, Arrayretries
- (Integer) Number of times to retry requests on server error.timeout
- (Integer) Default timeout to use in requests.endpoint
- (String) Override of the endpoint host name, ornil
to use the default endpoint.
- (Google::Cloud.configure.dns)
- (Google::Cloud::Config) — The configuration object the Google::Cloud::Dns library uses.
.new
def self.new(project_id: nil, credentials: nil, scope: nil, retries: nil, timeout: nil, endpoint: nil, project: nil, keyfile: nil) -> Google::Cloud::Dns::Project
Creates a new Project
instance connected to the DNS service.
Each call creates a new connection.
For more information on connecting to Google Cloud see the Authentication Guide.
- project_id (String) (defaults to: nil) — Identifier for a DNS project. If not present, the default project for the credentials is used.
- credentials (String, Hash, Google::Auth::Credentials) (defaults to: nil) — The path to the keyfile as a String, the contents of the keyfile as a Hash, or a Google::Auth::Credentials object. (See Credentials)
-
scope (String, Array<String>) (defaults to: nil) —
The OAuth 2.0 scopes controlling the set of resources and operations that the connection can access. See Using OAuth 2.0 to Access Google APIs.
The default scope is:
https://www.googleapis.com/auth/ndev.clouddns.readwrite
-
retries (Integer) (defaults to: nil) — Number of times to retry requests on server
error. The default value is
3
. Optional. - timeout (Integer) (defaults to: nil) — Default timeout to use in requests. Optional.
- endpoint (String) (defaults to: nil) — Override of the endpoint host name. Optional. If the param is nil, uses the default endpoint.
-
project (String) (defaults to: nil) — Alias for the
project_id
argument. Deprecated. -
keyfile (String) (defaults to: nil) — Alias for the
credentials
argument. Deprecated.
- (ArgumentError)
require "google/cloud/dns" dns = Google::Cloud::Dns.new( project_id: "my-dns-project", credentials: "/path/to/keyfile.json" ) zone = dns.zone "example-com"
Constants
VERSION
value: "0.36.1".freeze