Perform PUT Request for Non-Existing Records
If you have an infrastructure that uses public DNS records and manage it by defining the required state, you can use Cloud DNS as follows:
Create a DNS Zone with Cloud DNS.
Generate a UUID (v3, v4, and v5 supported) for your DNS record.
Add to your infrastructure a PUT call for the desired record configuration with your UUID and assign it to the corresponding DNS zone ID.
Result: On a successful PUT request,
If the record does not exist, Cloud DNS creates the record with the specified configuration.
If a record already exists but with a different configuration, the record is updated.
Request
Response
202 Successful operation
Response Fields
id
string
UUID of the newly created DNS record
90d81ac0-3a30-44d4-95a5-12959effa6ee
createdDate
string
Record creation timestamp
2022-08-21T15:52:53Z
createdBy
string
Unique name of the identity that created the record
ionos:iam:cloud:31960002:users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3
createdByUserId
string
The unique ID of the user who created the record
87f9a82e-b28d-49ed-9d04-fba2c0459cd3
lastModifiedDate
string
Record update timestamp
2022-08-21T15:52:53Z
lastModifiedBy
string
Unique name of the identity that created the record
ionos:iam:cloud:31960002:users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3
lastModifiedByUserId
string
Unique ID of the user has last modified the record
63cef532-26fe-4a64-a4e0-de7c8a506c90
resourceURN
string
Unique name of the resource
ionos:<product>:<location>:<contract>:<resource-path>
zoneId
string
UUID of the DNS zone of the DNS record
2a4428b3-dbe0-4357-9c02-609025b3a40f
fqdn
string
Fully qualified domain name resulting from the record name and the zoneName
app.example.com
state
string
State of the request
CREATED
Last updated
Was this helpful?