curl --request GET \
--url https://dns.basaltic.sh/v1/zones/{zone_id}/records \
--header 'Authorization: Bearer <token>'import requests
url = "https://dns.basaltic.sh/v1/zones/{zone_id}/records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://dns.basaltic.sh/v1/zones/{zone_id}/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dns.basaltic.sh/v1/zones/{zone_id}/records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dns.basaltic.sh/v1/zones/{zone_id}/records"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dns.basaltic.sh/v1/zones/{zone_id}/records")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dns.basaltic.sh/v1/zones/{zone_id}/records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"records": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"crn": "crn:dns::my-account:zone/example.com/record/550e8400-e29b-41d4-a716-446655440000",
"zone_id": "550e8400-e29b-41d4-a716-446655440001",
"name": "www.example.com",
"type": "A",
"ttl": 300,
"managed": false,
"values": [
{
"content": "203.0.113.10",
"disabled": false
},
{
"content": "203.0.113.11",
"disabled": false
}
]
}
],
"meta": {
"total": 150,
"limit": 20,
"marker": "550e8400-e29b-41d4-a716-446655440000",
"has_more": true
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Listar registros
Lista os registros em uma zona DNS, newest-RRset-first. Suporta filtragem por type e uma correspondência exata em name. Keyset- paginated by record id (UUIDv7) — passa o último id da página anterior como marker.
Retorna apenas seus registros. As linhas que a plataforma carimba para si mesma — o SOA, o NS de ápice e o conjunto DNSSEC (DNSKEY, DS, NSEC/NSEC3, NSEC3PARAM, RRSIG, CDS, CDNSKEY) — são omitidas, a menos que você as solicite. Em uma zona assinada, eles superam em número os registros de clientes, nenhum deles pode ser editado ou excluído, e o material DNSSEC que você pode realmente querer está na própria zona sob dnssec.
Passe include_managed=true para obter a zona exatamente como ela é servida, que é o que uma ferramenta de diffing de zona quer.
curl --request GET \
--url https://dns.basaltic.sh/v1/zones/{zone_id}/records \
--header 'Authorization: Bearer <token>'import requests
url = "https://dns.basaltic.sh/v1/zones/{zone_id}/records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://dns.basaltic.sh/v1/zones/{zone_id}/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dns.basaltic.sh/v1/zones/{zone_id}/records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dns.basaltic.sh/v1/zones/{zone_id}/records"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dns.basaltic.sh/v1/zones/{zone_id}/records")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dns.basaltic.sh/v1/zones/{zone_id}/records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"records": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"crn": "crn:dns::my-account:zone/example.com/record/550e8400-e29b-41d4-a716-446655440000",
"zone_id": "550e8400-e29b-41d4-a716-446655440001",
"name": "www.example.com",
"type": "A",
"ttl": 300,
"managed": false,
"values": [
{
"content": "203.0.113.10",
"disabled": false
},
{
"content": "203.0.113.11",
"disabled": false
}
]
}
],
"meta": {
"total": 150,
"limit": 20,
"marker": "550e8400-e29b-41d4-a716-446655440000",
"has_more": true
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}dns:ListRecords. Consulte permissões de DNS para obter a lista completa, o que cada uma abrange e um exemplo de política.Autorizações
Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.
Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.
Parâmetros de caminho
ID da zona DNS
Parâmetros de consulta
Tipo de registro exato para filtrar (por ex. A, MX).
"A"
Nome exato do registro, em minúsculas com um ponto final opcional removido.
"www.example.com"
Exato CRN de registro aninhado. CRNs estrangeiros ou não correspondidos retornam uma página vazia; combinado com o nome antes da paginação.
Inclua as linhas com carimbo de plataforma (SOA, NS de ápice e o conjunto DNSSEC) ao lado das suas próprias. Desligado por padrão — eles não podem ser editados ou excluídos, e em uma zona assinada há mais deles do que há de você.
false
1 <= x <= 50050
Token de continuação — o último id de registro da página anterior.
"550e8400-e29b-41d4-a716-446655440000"

