Create a recordset (with its initial records).
curl --request POST \ --url https://stratum.example.com/v1/projects/example/dns/zones/example/recordsets \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "type": "A", "ttl": 60, "routingPolicy": "simple", "vpcId": "example", "aliasTarget": { "type": "lb", "id": "example" }, "records": [ { "content": "example", "weight": 1, "geoCountry": "example", "geoContinent": "example", "healthCheckId": 1, "latencyTargetId": 1 } ] }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”object
RR type. DS is the delegation signer a parent zone holds for a signed child; content is the RFC 4034 form <keytag> <algorithm> <digesttype> <digest>.
Scope this record to one VPC (split-horizon). The data plane serves it ONLY to a query arriving on that VPC’s scope port, where it shadows an untagged record of the same name and type; every other client, including the public front door, resolves as if it does not exist.
Omit for a normal record. The VPC must belong to the calling project a record aimed at another tenant’s VPC is rejected.
Points an A/AAAA record at a Stratum resource by id (the Route53 alias-to-ELB analog,). When set, the record’s addresses are maintained automatically from the target’s current address and records MUST be empty; only the simple routing policy is allowed. For an instance target the record resolves to the instance’s primary PRIVATE IP, and a companion <name> prefixed with public. is auto-published to the instance’s associated floating IP whenever one exists.
object
Target resource kind: lb (load-balancer public address), fip (floating IP), instance (primary private IP + a public. companion).
The target resource’s id (e.g. lb-…, fip-…, i-…). Must belong to the same project.
object
Relative weight for a weighted routing policy (0-255).
ISO 3166-1 alpha-2 country tag for the geo routing policy.
MaxMind 2-letter continent code (AF, AN, AS, EU, NA, OC, SA) for the geo routing policy.
Health check that gates this record for the failover / weighted policies. Must belong to the same project.
Latency target whose measured RTT ranks this record for the latency policy. Must belong to the same project.
Responses
Section titled “Responses”Created.
object
Scopes an instance record to its owning VPC, and is present only on split-horizon records - those served exclusively to queries arriving on that VPC’s scope port. Read it before treating two same-name records as duplicates: an instance typically has a pair, one with vpcId carrying the private address for in-VPC clients and one without carrying the floating IP for everyone else, and this is the only field that tells them apart.
RR type. DS is the delegation signer a parent zone holds for a signed child; content is the RFC 4034 form <keytag> <algorithm> <digesttype> <digest>.
Points an A/AAAA record at a Stratum resource by id (the Route53 alias-to-ELB analog,). When set, the record’s addresses are maintained automatically from the target’s current address and records MUST be empty; only the simple routing policy is allowed. For an instance target the record resolves to the instance’s primary PRIVATE IP, and a companion <name> prefixed with public. is auto-published to the instance’s associated floating IP whenever one exists.
object
Target resource kind: lb (load-balancer public address), fip (floating IP), instance (primary private IP + a public. companion).
The target resource’s id (e.g. lb-…, fip-…, i-…). Must belong to the same project.
True for a reconciler-owned alias record (e.g. an auto-published public. companion); such records are read-only via the API.
True for a record the control plane owns: every zone’s apex NS, which names the install’s nameserver (ns1.
object
ISO 3166-1 alpha-2 country tag for the geo routing policy.
MaxMind 2-letter continent code (AF, AN, AS, EU, NA, OC, SA) for the geo routing policy.
Health check that gates this record for the failover / weighted policies; null = always healthy.
Latency target whose measured RTT ranks this record for the latency policy.
Example
{ "type": "A", "routingPolicy": "simple", "aliasTarget": { "type": "lb" }}Bad request.
object
The findings of a rejected IAM policy document (custom and resource policies).
One finding of a rejected IAM policy document. A rejection lists every finding, so the author fixes the document in one round trip.
object
The finding, e.g. INVALID_DOCUMENT, UNKNOWN_ACTION, ACTION_NOT_APPLICABLE.
Index of the statement at fault; -1 for the document as a whole.
The offending action, where one is at fault (ACTION_NOT_APPLICABLE).
Field errors, for codes that carry them: each problem at its field
(see FieldError). Documented on the responses that set it, e.g.
approveNodeJoin’s INVALID_INPUT and JOIN_APPROVAL_REFUSED.
Absent otherwise.
One field’s problem, the stage-2 installer API’s shape.
field is the field’s path, message what is wrong with it.
object
The field’s path, e.g. links[0].interface, disks[1].confirm,
mgmt.address or role; empty for the whole request.
Structured facts about the refusal, for codes that carry them. The
shape is fixed per code and documented on the response that answers
it, e.g. IMAGE_POOL_MISMATCH (see ImagePoolMismatchDetails) and
IMAGE_IN_USE. Absent for codes that carry none.
object
Example
{ "issues": [ { "code": "ACTION_NOT_APPLICABLE", "action": "compute:CreateVpc" } ]}Resource not found.
object
The findings of a rejected IAM policy document (custom and resource policies).
One finding of a rejected IAM policy document. A rejection lists every finding, so the author fixes the document in one round trip.
object
The finding, e.g. INVALID_DOCUMENT, UNKNOWN_ACTION, ACTION_NOT_APPLICABLE.
Index of the statement at fault; -1 for the document as a whole.
The offending action, where one is at fault (ACTION_NOT_APPLICABLE).
Field errors, for codes that carry them: each problem at its field
(see FieldError). Documented on the responses that set it, e.g.
approveNodeJoin’s INVALID_INPUT and JOIN_APPROVAL_REFUSED.
Absent otherwise.
One field’s problem, the stage-2 installer API’s shape.
field is the field’s path, message what is wrong with it.
object
The field’s path, e.g. links[0].interface, disks[1].confirm,
mgmt.address or role; empty for the whole request.
Structured facts about the refusal, for codes that carry them. The
shape is fixed per code and documented on the response that answers
it, e.g. IMAGE_POOL_MISMATCH (see ImagePoolMismatchDetails) and
IMAGE_IN_USE. Absent for codes that carry none.
object
Example
{ "issues": [ { "code": "ACTION_NOT_APPLICABLE", "action": "compute:CreateVpc" } ]}Conflicting state.
object
The findings of a rejected IAM policy document (custom and resource policies).
One finding of a rejected IAM policy document. A rejection lists every finding, so the author fixes the document in one round trip.
object
The finding, e.g. INVALID_DOCUMENT, UNKNOWN_ACTION, ACTION_NOT_APPLICABLE.
Index of the statement at fault; -1 for the document as a whole.
The offending action, where one is at fault (ACTION_NOT_APPLICABLE).
Field errors, for codes that carry them: each problem at its field
(see FieldError). Documented on the responses that set it, e.g.
approveNodeJoin’s INVALID_INPUT and JOIN_APPROVAL_REFUSED.
Absent otherwise.
One field’s problem, the stage-2 installer API’s shape.
field is the field’s path, message what is wrong with it.
object
The field’s path, e.g. links[0].interface, disks[1].confirm,
mgmt.address or role; empty for the whole request.
Structured facts about the refusal, for codes that carry them. The
shape is fixed per code and documented on the response that answers
it, e.g. IMAGE_POOL_MISMATCH (see ImagePoolMismatchDetails) and
IMAGE_IN_USE. Absent for codes that carry none.
object
Example
{ "issues": [ { "code": "ACTION_NOT_APPLICABLE", "action": "compute:CreateVpc" } ]}