Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



ManagedZones: create

Requires authorization

Creates a new managed zone. Try it now or see an example .

Request

HTTP request

POST https://www.googleapis.com/dns/v1beta1/projects/project/managedZones

Parameters

Parameter name Value Description
Path parameters
project string Identifies the project addressed by this request.

Authorization

This request requires authorization with at least one of the following scopes ( read more about authentication and authorization ).

Scope
https://www.googleapis.com/auth/ndev.clouddns.readwrite
https://www.googleapis.com/auth/cloud-platform

Request body

In the request body, supply a ManagedZones resource .

Response

If successful, this method returns a ManagedZones resource in the response body.

Examples

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).

Python

Uses the Python client library .

from apiclient import errors
# ...

BODY = {
  'name' : 'yourzonename',
  'dnsName' : 'example.com.',
  'description' : 'Example zone'
}

try:
  response = service.managedzones().create(project=PROJECT_NAME,
                                           body=BODY
                                           ).execute()
except errors.HttpError, error:
  print 'An error occurred: %s' % error

Ruby

Uses the Ruby client library .

##
# Create a managed zone
#
# @param [Google::APIClient] client
#   Authorized client instance.
# @param [String] project_name
#   The name of the project.
# @param [String] zone_name
#   The name of the zone.
# @param [String] dns_name
#   The DNS domain that this zone manages.
# @param [String] descr
#   A description of the zone.
def create_zone(client, project_name, zone_name, dns_name, descr)
  service = client.discovered_api('dns', 'v1beta1')

  body = {
    :project => project_name,
    :managedZone => zone_name,
    :body => {
      :name => zone_name,
      :dnsName => dns_name,
      :description => descr
    }
  }

  result = service.execute(
    :api_method => service.managedzones.create,
    :body_object => body )
  if result.error?
    puts "An error occurred: #{result.data['error']['message']}"
  end
end

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.