Record Sets - Update

サービス:: DNS

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

プライベート DNS ゾーン内のレコードセットを更新します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}?api-version=2018-09-01

URI パラメーター

名前	/	必須	型	説明
privateZoneName	path	True	string	プライベート DNS ゾーンの名前 (終了ドットなし)。
recordType	path	True	RecordType	このレコードセット内の DNS レコードの種類。
relativeRecordSetName	path	True	string	ゾーンの名前を基準としたレコードセットの名前。
resourceGroupName	path	True	string	リソースグループの名前。
subscriptionId	path	True	string	Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報を取得します。サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。
api-version	query	True	string	クライアント API のバージョン。

要求ヘッダー

名前	必須	型	説明
If-Match		string	レコードセットの ETag。現在のレコードセットを常に上書きするには、この値を省略します。同時変更が誤って上書きされないように、最後に表示された ETag 値を指定します。

要求本文

名前	型	説明
etag	string	レコードセットの ETag。
properties.aRecords	ARecord[]	レコードセット内の A レコードの一覧。
properties.aaaaRecords	AaaaRecord[]	レコードセット内の AAAA レコードの一覧。
properties.cnameRecord	CnameRecord	レコードセット内の CNAME レコード。
properties.metadata	object	レコードセットにアタッチされたメタデータ。
properties.mxRecords	MxRecord[]	レコードセット内の MX レコードの一覧。
properties.ptrRecords	PtrRecord[]	レコードセット内の PTR レコードの一覧。
properties.soaRecord	SoaRecord	レコードセット内の SOA レコード。
properties.srvRecords	SrvRecord[]	レコードセット内の SRV レコードの一覧。
properties.ttl	integer (int64)	レコードセット内のレコードの TTL (有効期間)。
properties.txtRecords	TxtRecord[]	レコードセット内の TXT レコードの一覧。

応答

名前	型	説明
200 OK	RecordSet	レコードセットが更新されました。
Other Status Codes	CloudError	既定の応答。エラー定義に従って逆シリアル化されます。

例

PATCH Private DNS Zone A Record Set

PATCH Private DNS Zone AAAA Record Set

PATCH Private DNS Zone CNAME Record Set

PATCH Private DNS Zone MX Record Set

PATCH Private DNS Zone PTR Record Set

PATCH Private DNS Zone SOA Record Set

PATCH Private DNS Zone SRV Record Set

PATCH Private DNS Zone TXT Record Set

PATCH Private DNS Zone A Record Set

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recordA?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recorda",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recorda",
  "type": "Microsoft.Network/privateDnsZones/A",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recorda.privatezone1.com.",
    "isAutoRegistered": false,
    "aRecords": [
      {
        "ipv4Address": "1.2.3.4"
      }
    ]
  }
}

PATCH Private DNS Zone AAAA Record Set

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordAAAA?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordaaaa",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordaaaa",
  "type": "Microsoft.Network/privateDnsZones/AAAA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordaaaa.privatezone1.com.",
    "isAutoRegistered": false,
    "aaaaRecords": [
      {
        "ipv6Address": "::1"
      }
    ]
  }
}

PATCH Private DNS Zone CNAME Record Set

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/CNAME/recordCNAME?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/CNAME/recordcname",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordcname",
  "type": "Microsoft.Network/privateDnsZones/CNAME",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordcname.privatezone1.com.",
    "isAutoRegistered": false,
    "cnameRecord": {
      "cname": "contoso.com"
    }
  }
}

PATCH Private DNS Zone MX Record Set

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordMX?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordmx",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordmx",
  "type": "Microsoft.Network/privateDnsZones/MX",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordmx.privatezone1.com.",
    "isAutoRegistered": false,
    "mxRecords": [
      {
        "preference": 0,
        "exchange": "mail.privatezone1.com"
      }
    ]
  }
}

PATCH Private DNS Zone PTR Record Set

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "1",
  "type": "Microsoft.Network/privateDnsZones/PTR",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "1.0.0.127.in-addr.arpa.",
    "isAutoRegistered": false,
    "ptrRecords": [
      {
        "ptrdname": "localhost"
      }
    ]
  }
}

PATCH Private DNS Zone SOA Record Set

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SOA/@?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SOA/@",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "@",
  "type": "Microsoft.Network/privateDnsZones/SOA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "privatezone1.com.",
    "isAutoRegistered": false,
    "soaRecord": {
      "host": "azureprivatedns.net",
      "email": "azureprivatedns-hostmaster.microsoft.com",
      "serialNumber": 1,
      "refreshTime": 3600,
      "retryTime": 300,
      "expireTime": 2419200,
      "minimumTtl": 300
    }
  }
}

PATCH Private DNS Zone SRV Record Set

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SRV/recordSRV?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SRV/recordsrv",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordsrv",
  "type": "Microsoft.Network/privateDnsZones/SRV",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordsrv.privatezone1.com.",
    "isAutoRegistered": false,
    "srvRecords": [
      {
        "priority": 0,
        "weight": 10,
        "port": 80,
        "target": "contoso.com"
      }
    ]
  }
}

PATCH Private DNS Zone TXT Record Set

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/TXT/recordTXT?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/TXT/recordtxt",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordtxt",
  "type": "Microsoft.Network/privateDnsZones/TXT",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordtxt.privatezone1.com.",
    "isAutoRegistered": false,
    "txtRecords": [
      {
        "value": [
          "string1",
          "string2"
        ]
      }
    ]
  }
}

定義

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

AaaaRecord

Object

AAAA レコード。

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

ARecord

Object

A レコード。

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

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 レコードの基本設定値。

PtrRecord

Object

PTR レコード。

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

RecordSet

Object

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

名前	型	説明
etag	string	レコードセットの ETag。
id	string	レコードセットの ID。
name	string	レコードセットの名前。
properties.aRecords	ARecord[]	レコードセット内の A レコードの一覧。
properties.aaaaRecords	AaaaRecord[]	レコードセット内の AAAA レコードの一覧。
properties.cnameRecord	CnameRecord	レコードセット内の CNAME レコード。
properties.fqdn	string	レコードセットの完全修飾ドメイン名。
properties.isAutoRegistered	boolean	レコードセットは、仮想ネットワークリンクを介してプライベート DNS ゾーンに自動登録されますか?
properties.metadata	object	レコードセットにアタッチされたメタデータ。
properties.mxRecords	MxRecord[]	レコードセット内の MX レコードの一覧。
properties.ptrRecords	PtrRecord[]	レコードセット内の PTR レコードの一覧。
properties.soaRecord	SoaRecord	レコードセット内の SOA レコード。
properties.srvRecords	SrvRecord[]	レコードセット内の SRV レコードの一覧。
properties.ttl	integer (int64)	レコードセット内のレコードの TTL (有効期間)。
properties.txtRecords	TxtRecord[]	レコードセット内の TXT レコードの一覧。
type	string	レコードセットの型。

RecordType

列挙

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

値	説明
A
AAAA
CNAME
MX
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 レコードの重み値。

TxtRecord

Object

TXT レコード。

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

次の方法で共有

Record Sets - Update

URI パラメーター

要求ヘッダー

要求本文

応答

例

PATCH Private DNS Zone A Record Set

要求のサンプル

応答のサンプル

PATCH Private DNS Zone AAAA Record Set

要求のサンプル

応答のサンプル

PATCH Private DNS Zone CNAME Record Set

要求のサンプル

応答のサンプル

PATCH Private DNS Zone MX Record Set

要求のサンプル

応答のサンプル

PATCH Private DNS Zone PTR Record Set

要求のサンプル

応答のサンプル

PATCH Private DNS Zone SOA Record Set

要求のサンプル

応答のサンプル

PATCH Private DNS Zone SRV Record Set

要求のサンプル

応答のサンプル

PATCH Private DNS Zone TXT Record Set

要求のサンプル

応答のサンプル

定義

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord