Private Zones - Update
匯報 私用 DNS 區域。 不會修改區域內的虛擬網路連結或 DNS 記錄。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}?api-version=2018-09-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
private
|
path | True |
string |
沒有終止點) 的 私用 DNS 區域名稱 (。 |
resource
|
path | True |
string |
資源群組的名稱。 |
subscription
|
path | True |
string |
取得用來唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。 |
api-version
|
query | True |
string |
用戶端 API 版本。 |
要求標頭
名稱 | 必要 | 類型 | Description |
---|---|---|---|
If-Match |
string |
私用 DNS 區域的ETag。 請省略此值以一律覆寫目前的區域。 指定上次出現的 ETag 值,以防止意外覆寫任何並行變更。 |
要求本文
名稱 | 類型 | Description |
---|---|---|
etag |
string |
區域的 ETag。 |
location |
string |
資源所在的 Azure 區域 |
tags |
object |
資源標籤。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
私用 DNS 區域已更新。 |
|
202 Accepted |
已接受 私用 DNS 區域更新作業,並以異步方式完成。 |
|
Other Status Codes |
默認回應。 它會根據錯誤定義還原串行化。 |
範例
PATCH Private DNS Zone
範例要求
PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com?api-version=2018-09-01
{
"tags": {
"key2": "value2"
}
}
範例回覆
{
"id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com",
"name": "privatezone1.com",
"type": "Microsoft.Network/privateDnsZones",
"location": "global",
"etag": "00000000-0000-0000-0000-000000000000",
"properties": {
"maxNumberOfRecordSets": 5000,
"numberOfRecordSets": 1,
"maxNumberOfVirtualNetworkLinks": 100,
"numberOfVirtualNetworkLinks": 0,
"maxNumberOfVirtualNetworkLinksWithRegistration": 50,
"numberOfVirtualNetworkLinksWithRegistration": 0,
"provisioningState": "Succeeded"
},
"tags": {
"key2": "value2"
}
}
Location: https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsOperationResults/asyncOperationId?api-version=2018-09-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsOperationStatuses/asyncOperationId?api-version=2018-09-01
Retry-After: 60
定義
名稱 | Description |
---|---|
Cloud |
來自服務的錯誤回應。 |
Cloud |
來自服務的錯誤回應。 |
Private |
描述 私用 DNS 區域。 |
Provisioning |
資源的布建狀態。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。 |
CloudError
來自服務的錯誤回應。
名稱 | 類型 | Description |
---|---|---|
error |
雲端錯誤本文。 |
CloudErrorBody
來自服務的錯誤回應。
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤的識別碼。 程式碼不變,且要以程式設計方式使用。 |
details |
錯誤的其他詳細數據清單。 |
|
message |
string |
描述錯誤的訊息,適用於在使用者介面中顯示。 |
target |
string |
特定錯誤的目標。 例如,錯誤中屬性的名稱。 |
PrivateZone
描述 私用 DNS 區域。
名稱 | 類型 | Description |
---|---|---|
etag |
string |
區域的 ETag。 |
id |
string |
資源的完整資源標識碼。 範例 - '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}'。 |
location |
string |
資源所在的 Azure 區域 |
name |
string |
資源的名稱 |
properties.maxNumberOfRecordSets |
integer |
在此 私用 DNS 區域中可建立的記錄集數目上限。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。 |
properties.maxNumberOfVirtualNetworkLinks |
integer |
可連結至此 私用 DNS 區域的虛擬網路數目上限。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。 |
properties.maxNumberOfVirtualNetworkLinksWithRegistration |
integer |
可連結至已啟用註冊之此 私用 DNS 區域的虛擬網路數目上限。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。 |
properties.numberOfRecordSets |
integer |
此 私用 DNS 區域中目前的記錄集數目。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。 |
properties.numberOfVirtualNetworkLinks |
integer |
連結至此 私用 DNS 區域的目前虛擬網路數目。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。 |
properties.numberOfVirtualNetworkLinksWithRegistration |
integer |
目前連結至此 私用 DNS 區域且已啟用註冊的虛擬網路數目。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。 |
properties.provisioningState |
資源的布建狀態。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。 |
|
tags |
object |
資源標籤。 |
type |
string |
資源類型。 範例 - 'Microsoft.Network/privateDnsZones'。 |
ProvisioningState
資源的布建狀態。 這是唯讀屬性,而且將會忽略任何設定此值的嘗試。
名稱 | 類型 | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |