Skip to main content

domains

Overview

Namedomains
TypeResource
Iddigitalocean.domains.domains

Fields

NameDatatypeDescription
namestringThe name of the domain itself. This should follow the standard domain format of domain.TLD. For instance, example.com is a valid domain name.
ip_addressstringThis optional attribute may contain an IP address. When provided, an A record will be automatically created pointing to the apex domain.
ttlintegerThis value is the time to live for the records on this domain, in seconds. This defines the time frame that clients can cache queried information before a refresh should be requested.
zone_filestringThis attribute contains the complete contents of the zone file for the selected domain. Individual domain record resources should be used to get more granular control over records. However, this attribute can also be used to get information about the SOA record, which is created automatically and is not accessible as an individual record resource.

Methods

NameAccessible byRequired ParamsDescription
getSELECTdomain_nameTo get details about a specific domain, send a GET request to /v2/domains/$DOMAIN_NAME.
listSELECTTo retrieve a list of all of the domains in your account, send a GET request to /v2/domains.
createINSERTTo create a new domain, send a POST request to /v2/domains. Set the "name"
attribute to the domain name you are adding. Optionally, you may set the
"ip_address" attribute, and an A record will be automatically created pointing
to the apex domain.
deleteDELETEdomain_nameTo delete a domain, send a DELETE request to /v2/domains/$DOMAIN_NAME.
_getEXECdomain_nameTo get details about a specific domain, send a GET request to /v2/domains/$DOMAIN_NAME.
_listEXECTo retrieve a list of all of the domains in your account, send a GET request to /v2/domains.