zone_records
Creates, updates, deletes, gets or lists a zone_records resource.
Overview​
| Name | zone_records |
| Type | Resource |
| Id | oci.dns.zone_records |
Fields​
The following fields are returned by SELECT queries:
- get
A collection of DNS resource record objects.
| Name | Datatype | Description |
|---|---|---|
items | array |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | zoneNameOrId, region | If-None-Match, If-Modified-Since, opc-request-id, limit, page, zoneVersion, domain, domainContains, rtype, sortBy, sortOrder, compartmentId, scope, viewId | Gets all records in the specified zone.<br /><br />The results are sorted by domain in alphabetical order by default. For more information about records,<br />see [Resource Record (RR) TYPEs](https:​//www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4).<br />When the zone name is provided as a path parameter and PRIVATE is used for the scope query parameter<br />then the viewId query parameter is required.<br /> |
update | update | zoneNameOrId, region | If-Match, If-Unmodified-Since, opc-request-id, scope, viewId, compartmentId | Replaces records in the specified zone with the records specified in the request body.<br /><br />If a specified record does not exist, it will be created. If the record exists, then it will be updated<br />to represent the record in the body of the request. If a record in the zone does not exist in the<br />request body, the record will be removed from the zone. When the zone name is provided as a path<br />parameter and PRIVATE is used for the scope query parameter then the viewId query parameter is<br />required.<br /> |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | OCI region identifier (e.g. us-ashburn-1, ap-sydney-1); resolves from OCI_REGION when not supplied in the query. (default: us-ashburn-1, x-stackQL-envVar: OCI_REGION) |
zoneNameOrId | string | The name or OCID of the target zone. |
If-Match | string | The If-Match header field makes the request method conditional on the existence of at least one current representation of the target resource, when the field-value is *, or having a current representation of the target resource that has an entity-tag matching a member of the list of entity-tags provided in the field-value. |
If-Modified-Since | string | The If-Modified-Since header field makes a GET or HEAD request method conditional on the selected representation's modification date being more recent than the date provided in the field-value. Transfer of the selected representation's data is avoided if that data has not changed. |
If-None-Match | string | The If-None-Match header field makes the request method conditional on the absence of any current representation of the target resource, when the field-value is *, or having a selected representation with an entity-tag that does not match any of those listed in the field-value. |
If-Unmodified-Since | string | The If-Unmodified-Since header field makes the request method conditional on the selected representation's last modification date being earlier than or equal to the date provided in the field-value. This field accomplishes the same purpose as If-Match for cases where the user agent does not have an entity-tag for the representation. |
compartmentId | string | The OCID of the compartment the zone belongs to. This parameter is deprecated and should be omitted. |
domain | string | Search by domain. Will match any record whose domain (case-insensitive) equals the provided value. |
domainContains | string | Search by domain. Will match any record whose domain (case-insensitive) contains the provided value. |
limit | integer (int64) | The maximum number of items to return in a page of the collection. |
opc-request-id | string | Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
page | string | The value of the opc-next-page response header from the previous "List" call. |
rtype | string | Search by record type. Will match any record whose [type](https:​//www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4) (case-insensitive) equals the provided value. |
scope | string | Specifies to operate only on resources that have a matching DNS scope. |
sortBy | string | The field by which to sort records. |
sortOrder | string | The order to sort the resources. |
viewId | string | The OCID of the view the zone is associated with. Required when accessing a private zone by name. |
zoneVersion | string | The version of the zone for which data is requested. |
SELECT examples​
- get
Gets all records in the specified zone.<br /><br />The results are sorted by domain in alphabetical order by default. For more information about records,<br />see [Resource Record (RR) TYPEs](https:​//www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4).<br />When the zone name is provided as a path parameter and PRIVATE is used for the scope query parameter<br />then the viewId query parameter is required.<br />
SELECT
items
FROM oci.dns.zone_records
WHERE zoneNameOrId = '{{ zoneNameOrId }}' -- required
AND region = '{{ region }}' -- required
AND If-None-Match = '{{ If-None-Match }}'
AND If-Modified-Since = '{{ If-Modified-Since }}'
AND opc-request-id = '{{ opc-request-id }}'
AND limit = '{{ limit }}'
AND page = '{{ page }}'
AND zoneVersion = '{{ zoneVersion }}'
AND domain = '{{ domain }}'
AND domainContains = '{{ domainContains }}'
AND rtype = '{{ rtype }}'
AND sortBy = '{{ sortBy }}'
AND sortOrder = '{{ sortOrder }}'
AND compartmentId = '{{ compartmentId }}'
AND scope = '{{ scope }}'
AND viewId = '{{ viewId }}'
;
UPDATE examples​
- update
Replaces records in the specified zone with the records specified in the request body.<br /><br />If a specified record does not exist, it will be created. If the record exists, then it will be updated<br />to represent the record in the body of the request. If a record in the zone does not exist in the<br />request body, the record will be removed from the zone. When the zone name is provided as a path<br />parameter and PRIVATE is used for the scope query parameter then the viewId query parameter is<br />required.<br />
UPDATE oci.dns.zone_records
SET
items = '{{ items }}'
WHERE
zoneNameOrId = '{{ zoneNameOrId }}' --required
AND region = '{{ region }}' --required
AND If-Match = '{{ If-Match}}'
AND If-Unmodified-Since = '{{ If-Unmodified-Since}}'
AND opc-request-id = '{{ opc-request-id}}'
AND scope = '{{ scope}}'
AND viewId = '{{ viewId}}'
AND compartmentId = '{{ compartmentId}}'
RETURNING
items;