Zones - Create Or Update
DNS ゾーンを作成または更新します。 ゾーン内の DNS レコードは変更しません。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}?api-version=2018-05-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
resource
|
path | True |
string |
リソース グループの名前。 |
subscription
|
path | True |
string |
Microsoft Azure サブスクリプションを一意に識別する Azure サブスクリプション ID を指定します。 |
zone
|
path | True |
string |
DNS ゾーンの名前 (終了ドットなし)。 |
api-version
|
query | True |
string |
API バージョンを指定します。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
If-Match |
string |
DNS ゾーンの etag。 現在のゾーンを常に上書きするには、この値を省略します。 同時変更が誤って上書きされないように、最後に表示される etag 値を指定します。 |
|
If-None-Match |
string |
新しい DNS ゾーンの作成を許可するが、既存のゾーンを更新できないようにするには、'*' に設定します。 その他の値は無視されます。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
location | True |
string |
リソースの場所。 |
etag |
string |
ゾーンの etag。 |
|
properties.registrationVirtualNetworks |
この DNS ゾーンにホスト名を登録する仮想ネットワークへの参照の一覧。 これは、ZoneType が Private の場合にのみです。 |
||
properties.resolutionVirtualNetworks |
この DNS ゾーン内のレコードを解決する仮想ネットワークへの参照の一覧。 これは、ZoneType が Private の場合にのみです。 |
||
properties.zoneType |
この DNS ゾーンの種類 (パブリックまたはプライベート)。 |
||
tags |
object |
リソース タグ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
DNS ゾーンが更新されました。 |
|
201 Created |
DNS ゾーンが作成されました。 |
|
Other Status Codes |
既定の応答。 エラー定義に従って逆シリアル化されます。 |
例
Create zone
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1?api-version=2018-05-01
{
"location": "Global",
"tags": {
"key1": "value1"
}
}
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1",
"etag": "00000000-0000-0000-0000-000000000000",
"location": "global",
"name": "zone1",
"type": "Microsoft.Network/dnsZones",
"properties": {
"maxNumberOfRecordSets": 5000,
"numberOfRecordSets": 2,
"nameServers": [
"ns1-01.azure-dns.com",
"ns2-01.azure-dns.net",
"ns3-01.azure-dns.org",
"ns4-01.azure-dns.info"
],
"zoneType": "Public"
},
"tags": {
"key1": "value1"
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1",
"etag": "00000000-0000-0000-0000-000000000000",
"location": "global",
"name": "zone1",
"type": "Microsoft.Network/dnsZones",
"properties": {
"maxNumberOfRecordSets": 5000,
"numberOfRecordSets": 2,
"nameServers": [
"ns1-01.azure-dns.com",
"ns2-01.azure-dns.net",
"ns3-01.azure-dns.org",
"ns4-01.azure-dns.info"
],
"zoneType": "Public"
},
"tags": {
"key1": "value1"
}
}
定義
名前 | 説明 |
---|---|
Cloud |
サービスからのエラー応答。 |
Cloud |
サービスからのエラー応答。 |
Sub |
別のリソースへの参照 |
Zone |
DNS ゾーンについて説明します。 |
Zone |
この DNS ゾーンの種類 (パブリックまたはプライベート)。 |
CloudError
サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
クラウド エラー本文。 |
CloudErrorBody
サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。 |
details |
エラーに関するその他の詳細の一覧。 |
|
message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
target |
string |
特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。 |
SubResource
別のリソースへの参照
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソース ID。 |
Zone
DNS ゾーンについて説明します。
名前 | 型 | 既定値 | 説明 |
---|---|---|---|
etag |
string |
ゾーンの etag。 |
|
id |
string |
リソースの ID |
|
location |
string |
リソースの場所。 |
|
name |
string |
リソース名。 |
|
properties.maxNumberOfRecordSets |
integer |
この DNS ゾーンに作成できるレコード セットの最大数。 これは読み取り専用プロパティであり、この値を設定しようとすると無視されます。 |
|
properties.maxNumberOfRecordsPerRecordSet |
integer |
この DNS ゾーンに作成できるレコード セットあたりのレコードの最大数。 これは読み取り専用プロパティであり、この値を設定しようとすると無視されます。 |
|
properties.nameServers |
string[] |
この DNS ゾーンのネーム サーバー。 これは読み取り専用プロパティであり、この値を設定しようとすると無視されます。 |
|
properties.numberOfRecordSets |
integer |
この DNS ゾーン内のレコード セットの現在の数。 これは読み取り専用プロパティであり、この値を設定しようとすると無視されます。 |
|
properties.registrationVirtualNetworks |
この DNS ゾーンにホスト名を登録する仮想ネットワークへの参照の一覧。 これは、ZoneType が Private の場合にのみです。 |
||
properties.resolutionVirtualNetworks |
この DNS ゾーン内のレコードを解決する仮想ネットワークへの参照の一覧。 これは、ZoneType が Private の場合にのみです。 |
||
properties.zoneType | Public |
この DNS ゾーンの種類 (パブリックまたはプライベート)。 |
|
tags |
object |
リソース タグ。 |
|
type |
string |
リソースの種類。 |
ZoneType
この DNS ゾーンの種類 (パブリックまたはプライベート)。
名前 | 型 | 説明 |
---|---|---|
Private |
string |
|
Public |
string |