ログイン

レコード一覧取得

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)		 asc
desc		 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のドキュメントにてご確認ください。