Record Sets - Get

サービス:: DNS

API バージョン:: 2018-05-01

レコードセットを取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}?api-version=2018-05-01

URI パラメーター

名前	/	必須	型	説明
recordType	path	True	RecordType	このレコードセット内の DNS レコードの種類。
relativeRecordSetName	path	True	string	ゾーンの名前を基準としたレコードセットの名前。
resourceGroupName	path	True	string	リソースグループの名前。
subscriptionId	path	True	string	Microsoft Azure サブスクリプションを一意に識別する Azure サブスクリプション ID を指定します。
zoneName	path	True	string	DNS ゾーンの名前 (終了ドットなし)。
api-version	query	True	string	API のバージョンを指定します。

応答

名前	型	説明
200 OK	RecordSet	成功。
Other Status Codes	CloudError	既定の応答。エラー定義に従って逆シリアル化されます。

例

Get A recordset

Get AAAA recordset

Get CAA recordset

Get CNAME recordset

Get MX recordset

Get NS recordset

Get PTR recordset

Get SOA recordset

Get SRV recordset

Get TXT recordset

Get A recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/A/record1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/A/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/A",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "ARecords": [
      {
        "ipv4Address": "127.0.0.1"
      }
    ]
  }
}

Get AAAA recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/AAAA/record1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/AAAA/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/AAAA",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "AAAARecords": [
      {
        "ipv6Address": "::1"
      }
    ]
  }
}

Get CAA recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA/record1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/CAA",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "caaRecords": [
      {
        "flags": 0,
        "tag": "issue",
        "value": "ca.contoso.com"
      }
    ]
  }
}

Get CNAME recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CNAME/record1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CNAME/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/CNAME",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "CNAMERecord": {
      "cname": "contoso.com"
    }
  }
}

Get MX recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/MX/record1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/MX/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/MX",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "MXRecords": [
      {
        "preference": 0,
        "exchange": "mail.contoso.com"
      }
    ]
  }
}

Get NS recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/NS/record1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/NS/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/NS",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "NSRecords": [
      {
        "nsdname": "ns1.contoso.com"
      }
    ]
  }
}

Get PTR recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/0.0.127.in-addr.arpa/PTR/1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/0.0.127.in-addr.arpa/PTR/1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "1",
  "type": "Microsoft.Network/dnsZones/PTR",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "1.0.0.127.in-addr.arpa",
    "PTRRecords": [
      {
        "ptrdname": "localhost"
      }
    ]
  }
}

Get SOA recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SOA/@?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SOA/@",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "@",
  "type": "Microsoft.Network/dnsZones/SOA",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "zone1",
    "SOARecord": {
      "host": "ns1.contoso.com",
      "email": "hostmaster.contoso.com",
      "serialNumber": 1,
      "refreshTime": 3600,
      "retryTime": 300,
      "expireTime": 2419200,
      "minimumTTL": 300
    }
  }
}

Get SRV recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SRV/record1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SRV/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/SRV",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "SRVRecords": [
      {
        "priority": 0,
        "weight": 10,
        "port": 80,
        "target": "contoso.com"
      }
    ]
  }
}

Get TXT recordset

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/TXT/record1?api-version=2018-05-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/TXT/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/TXT",
  "properties": {
    "metadata": {
      "key1": "value1"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "TXTRecords": [
      {
        "value": [
          "string1",
          "string2"
        ]
      }
    ]
  }
}

定義

名前	説明
AaaaRecord	AAAA レコード。
ARecord	A レコード。
CaaRecord	CAA レコード。
CloudError	サービスからのエラー応答。
CloudErrorBody	サービスからのエラー応答。
CnameRecord	CNAME レコード。
MxRecord	MX レコード。
NsRecord	NS レコード。
PtrRecord	PTR レコード。
RecordSet	DNS レコードセット (名前と種類が同じ DNS レコードのコレクション) について説明します。
RecordType	このレコードセット内の DNS レコードの種類。
SoaRecord	SOA レコード。
SrvRecord	SRV レコード。
SubResource	別のリソースへの参照
TxtRecord	TXT レコード。

AaaaRecord

Object

AAAA レコード。

名前	型	説明
ipv6Address	string	この AAAA レコードの IPv6 アドレス。

ARecord

Object

A レコード。

名前	型	説明
ipv4Address	string	この A レコードの IPv4 アドレス。

CaaRecord

Object

CAA レコード。

名前	型	説明
flags	integer (int32)	この CAA レコードのフラグは、0 ~ 255 の整数です。
tag	string	この CAA レコードのタグ。
value	string	この CAA レコードの値。

CloudError

Object

サービスからのエラー応答。

名前	型	説明
error	CloudErrorBody	クラウドエラー本文。

CloudErrorBody

Object

サービスからのエラー応答。

名前	型	説明
code	string	エラーの識別子。コードは不変であり、プログラムで使用することを目的としています。
details	CloudErrorBody[]	エラーに関する追加の詳細の一覧。
message	string	ユーザーインターフェイスでの表示に適したエラーを説明するメッセージ。
target	string	特定のエラーのターゲット。たとえば、エラーが発生したプロパティの名前です。

CnameRecord

Object

CNAME レコード。

名前	型	説明
cname	string	この CNAME レコードの正規名。

MxRecord

Object

MX レコード。

名前	型	説明
exchange	string	この MX レコードのメールホストのドメイン名。
preference	integer (int32)	この MX レコードの基本設定値。

NsRecord

Object

NS レコード。

名前	型	説明
nsdname	string	この NS レコードのネームサーバー名。

PtrRecord

Object

PTR レコード。

名前	型	説明
ptrdname	string	この PTR レコードの PTR ターゲットドメイン名。

RecordSet

Object

DNS レコードセット (名前と種類が同じ DNS レコードのコレクション) について説明します。

名前	型	説明
etag	string	レコードセットの etag。
id	string	レコードセットの ID。
name	string	レコードセットの名前。
properties.AAAARecords	AaaaRecord[]	レコードセット内の AAAA レコードの一覧。
properties.ARecords	ARecord[]	レコードセット内の A レコードの一覧。
properties.CNAMERecord	CnameRecord	レコードセット内の CNAME レコード。
properties.MXRecords	MxRecord[]	レコードセット内の MX レコードの一覧。
properties.NSRecords	NsRecord[]	レコードセット内の NS レコードの一覧。
properties.PTRRecords	PtrRecord[]	レコードセット内の PTR レコードの一覧。
properties.SOARecord	SoaRecord	レコードセット内の SOA レコード。
properties.SRVRecords	SrvRecord[]	レコードセット内の SRV レコードの一覧。
properties.TTL	integer (int64)	レコードセット内のレコードの TTL (有効期間)。
properties.TXTRecords	TxtRecord[]	レコードセット内の TXT レコードの一覧。
properties.caaRecords	CaaRecord[]	レコードセット内の CAA レコードの一覧。
properties.fqdn	string	レコードセットの完全修飾ドメイン名。
properties.metadata	object	レコードセットにアタッチされたメタデータ。
properties.provisioningState	string	レコードセットのプロビジョニング状態。
properties.targetResource	SubResource	DNS リソースの値が取得される Azure リソースへの参照。
type	string	レコードセットの型。

RecordType

列挙

このレコードセット内の DNS レコードの種類。

値	説明
A
AAAA
CAA
CNAME
MX
NS
PTR
SOA
SRV
TXT

SoaRecord

Object

SOA レコード。

名前	型	説明
email	string	この SOA レコードの電子メール連絡先。
expireTime	integer (int64)	この SOA レコードの有効期限。
host	string	この SOA レコードの権限のあるネームサーバーのドメイン名。
minimumTTL	integer (int64)	この SOA レコードの最小値。慣例により、これは負のキャッシュ期間を決定するために使用されます。
refreshTime	integer (int64)	この SOA レコードの更新値。
retryTime	integer (int64)	この SOA レコードの再試行時間。
serialNumber	integer (int64)	この SOA レコードのシリアル番号。

SrvRecord

Object

SRV レコード。

名前	型	説明
port	integer (int32)	この SRV レコードのポート値。
priority	integer (int32)	この SRV レコードの優先順位の値。
target	string	この SRV レコードのターゲットドメイン名。
weight	integer (int32)	この SRV レコードの重み値。

SubResource

Object

別のリソースへの参照

名前	型	説明
id	string	リソース ID。

TxtRecord

Object

TXT レコード。

名前	型	説明
value	string[]	この TXT レコードのテキスト値。

次の方法で共有

Record Sets - Get

URI パラメーター

応答

例

Get A recordset

要求のサンプル

応答のサンプル

Get AAAA recordset

要求のサンプル

応答のサンプル

Get CAA recordset

要求のサンプル

応答のサンプル

Get CNAME recordset

要求のサンプル

応答のサンプル

Get MX recordset

要求のサンプル

応答のサンプル

Get NS recordset

要求のサンプル

応答のサンプル

Get PTR recordset

要求のサンプル

応答のサンプル

Get SOA recordset

要求のサンプル

応答のサンプル

Get SRV recordset

要求のサンプル

応答のサンプル

Get TXT recordset

要求のサンプル

応答のサンプル

定義

AaaaRecord

ARecord

CaaRecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

NsRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

SubResource

TxtRecord