Creating a Public Zone

Function

Create a public zone.

URI

POST /v2/zones

Request

• Parameter description

  Table 1 Parameters in the request

  Parameter	Mandatory	Type	Description
  name	Yes	String	Domain name registered with the domain name registrar If a domain name is ended with a dot (.), it cannot exceed 254 characters. If a domain name is not ended with a dot (.), the domain name cannot exceed 253 characters. Labels of a domain name are separated by dot (.). Each label cannot exceed 63 characters. A domain name is case insensitive. Uppercase letters will also be converted into lowercase letters.
  description	No	String	Description of the zone, which cannot exceed 255 characters The value is left blank by default.
  zone_type	No	String	Zone type, the value of which can be public or private public: public zones accessible to hosts on the Internet private: private zones accessible only to hosts in specified VPCs If the value is left blank, a public zone will be created. For details about creating a private zone, see section Creating a Private Zone.
  email	No	String	Email address of the administrator managing the zone The default value is the service email address.
  ttl	No	Integer	Caching period of the SOA record set (in seconds) The value ranges from 1 to 2147483647. The default value is 300.
  tags	No	Array of object	Resource tag. For details, see Table 2. The value is left blank by default.
  enterprise_project_id	No	String	Specifies the ID of the enterprise project associated with the public zone. The value contains a maximum of 36 characters. The default value is 0.

  Table 2 Description of the tags field

  Parameter	Mandatory	Type	Description
  key	Yes	String	Tag key. The key contains 36 Unicode characters at most and cannot be blank. It can contain only digits, letters, hyphens (-), and underscores (_).
  value	No	String	Tag value. Each value contains 43 Unicode characters at most and can be an empty string. It can contain only digits, letters, hyphens (-), and underscores (_).

• Example request

  Create a public zone named example.com.

  POST https://{DNS_Endpoint}/v2/zones
  

  {
      "name": "example.com.",
      "description": "This is an example zone.",
      "zone_type": "public",
      "email": "xx@example.org",
      "ttl": 300,
      "tags": [
          {
            "key": "key1",
            "value": "value1"
          }
      ]
  }
  

Response

• Parameter description

  Table 3 Parameters in the response

  Parameter	Type	Description
  id	String	Zone ID, which is a UUID used to identify the zone
  name	String	Zone name
  description	String	Zone description
  email	String	Email address of the administrator managing the zone
  zone_type	String	Zone type, which can be public or private
  ttl	Integer	TTL value of the SOA record set in the zone
  serial	Integer	Serial number in the SOA record set in a zone, which identifies the change on the primary DNS server This parameter is not used currently.
  status	String	Resource status For details, see Resource Status.
  record_num	Integer	Number of record sets in the zone
  pool_id	String	Pool ID of the zone, which is assigned by the system
  project_id	String	Project ID of the zone
  created_at	String	Time when the zone was created The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.
  updated_at	String	Time when the zone was updated The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.
  links	Object	Link to the current resource or other related resources. When a response is broken into pages, a next link is provided to retrieve all results. For details, see Table 4.
  enterprise_project_id	String	ID of the enterprise project associated with the public zone. The value contains a maximum of 36 characters
  masters	Array of strings	Master DNS servers, from which the slave servers get DNS information This parameter is not used currently.

  Table 4 Description of the links field

  Parameter	Type	Description
  self	String	Link to the current resource
  next	String	Link to the next page

• Example response

  {
      "id": "2c9eb155587194ec01587224c9f90149",
      "name": "example.com.",
      "description": "This is an example zone.",
      "email": "xx@example.com",
      "ttl": 300,
      "serial": 1,
      "masters": [],
      "status": "PENDING_CREATE",
      "links": {
          "self": "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149"
      },
      "pool_id": "00000000570e54ee01570e9939b20019",
      "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
      "zone_type": "public",
      "created_at": "2016-11-17T11:56:03.439",
      "updated_at": null,
      "record_num": 0
  }
  

Returned Value

If the API call returns a code of 2xx, for example, 200, 202, or 204, the request is successful.

For details, see Status Code.

last updated: 2024-05-07 00:19