Description
指定したドメインに設定されているDNSレコードの一覧を取得します。
Request URL
DNS API
GET /v1/domains/{domainid}/records
Request Json
This operation does not accept a request body.
Request Parameters
| Parameter | Value | Style | Description |
|---|---|---|---|
| X-Auth-Token | トークン | header | トークンの情報を指定します。トークンの発行方法は、トークン発行 にてご確認ください。 |
| domainid | ドメインID | path | 対象ドメインのUUIDとして設定されているドメインIDを指定します。ドメインIDの確認方法は、ドメイン一覧取得 を実行の上、レスポンス結果から対象ドメインのドメインIDをご確認ください。 |
| limit(Optional) | 表示件数 | query | 取得する情報の表示件数を指定します。 |
| offset(Optional) | 開始位置 | query | 取得する情報の開始位置を指定します。「limit」と併せて使用します。 |
| sort_type(Optional) | ascdesc | query | ソート対象の並び順を指定します。並び順は、「asc(昇順) 」または「desc(降順)」が指定できます。デフォルトの項目は「desc」です。 |
| sort_key(Optional) | 項目 | query | ソート対象の項目を指定します。デフォルトの項目は「created_at」です。 |
Response Code
Success
200
Example
Request
curl -X GET -H "Accept: application/json" -H "X-Auth-Token: トークン" https://dns-service.c3j1.conoha.io/v1/domains/ドメインID/records
Response
{
"records": [
{
"uuid": "レコードID",
"domain_uuid": "ドメインID",
"name": "ドメイン名.",
"type": "SOA",
"data": "a.conoha-dns.com. postmaster.example.org. 1701909248 3600 600 86400 3600",
"priority": null,
"weight": null,
"port": null,
"ttl": 3600,
"created_at": "2023-12-07T00:34:09Z",
"updated_at": "2023-12-07T00:34:09Z"
},
{
"uuid": "レコードID",
"domain_uuid": "ドメインID",
"name": "ドメイン名.",
"type": "NS",
"data": "a.conoha-dns.com.",
"priority": null,
"weight": null,
"port": null,
"ttl": 3600,
"created_at": "2023-12-07T00:34:09Z",
"updated_at": "2023-12-07T00:34:09Z"
},
{
"uuid": "レコードID",
"domain_uuid": "ドメインID",
"name": "ドメイン名.",
"type": "NS",
"data": "b.conoha-dns.org.",
"priority": null,
"weight": null,
"port": null,
"ttl": 3600,
"created_at": "2023-12-07T00:34:09Z",
"updated_at": "2023-12-07T00:34:09Z"
}
],
"total_count": 3
}
ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。
