你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Virtual Network Links - Create Or Update

创建或更新到指定专用 DNS区域的虚拟网络链接。

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

URI 参数

名称 必需 类型 说明
privateZoneName
path True

string

不带终止点) (专用 DNS区域的名称。

resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

获取唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

virtualNetworkLinkName
path True

string

虚拟网络链接的名称。

api-version
query True

string

客户端 API 版本。

请求头

名称 必需 类型 说明
If-Match

string

虚拟网络的 ETag 链接到专用 DNS区域。 省略此值将始终覆盖当前虚拟网络链接。 指定上次看到的 ETag 值,以防止意外覆盖任何并发更改。

If-None-Match

string

设置为“*”以允许创建指向专用 DNS区域的新虚拟网络链接,但阻止更新现有链接。 其他值将被忽略。

请求正文

名称 类型 说明
etag

string

虚拟网络链接的 ETag。

location

string

资源所在的 Azure 区域

properties.registrationEnabled

boolean

是否已启用专用 DNS区域中虚拟网络中的虚拟机记录自动注册?

properties.virtualNetwork

SubResource

虚拟网络的引用。

tags

object

资源标记。

响应

名称 类型 说明
200 OK

VirtualNetworkLink

已更新指向专用 DNS区域的虚拟网络链接。

201 Created

VirtualNetworkLink

已创建指向专用 DNS区域的虚拟网络链接。

202 Accepted

用于将虚拟网络链接更新到专用 DNS区域的操作已被接受,并且将以异步方式完成。

Other Status Codes

CloudError

默认响应。 它将根据错误定义进行反序列化。

示例

示例请求

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

{
  "location": "Global",
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "virtualNetwork": {
      "id": "/subscriptions/virtualNetworkSubscriptionId/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/virtualNetworkName"
    },
    "registrationEnabled": false
  }
}

示例响应

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/virtualNetworkLinks/virtualNetworkLink1",
  "name": "virtualNetworkLink1",
  "type": "Microsoft.Network/privateDnsZones/virtualNetworkLinks",
  "location": "global",
  "etag": "00000000-0000-0000-0000-000000000000",
  "properties": {
    "virtualNetwork": {
      "id": "/subscriptions/virtualNetworkSubscriptionId/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/virtualNetworkName"
    },
    "registrationEnabled": false,
    "virtualNetworkLinkState": "Completed",
    "provisioningState": "Succeeded"
  },
  "tags": {
    "key1": "value1"
  }
}
{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/virtualNetworkLinks/virtualNetworkLink1",
  "name": "virtualNetworkLink1",
  "type": "Microsoft.Network/privateDnsZones/virtualNetworkLinks",
  "location": "global",
  "etag": "00000000-0000-0000-0000-000000000000",
  "properties": {
    "virtualNetwork": {
      "id": "/subscriptions/virtualNetworkSubscriptionId/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/virtualNetworkName"
    },
    "registrationEnabled": false,
    "virtualNetworkLinkState": "Completed",
    "provisioningState": "Succeeded"
  },
  "tags": {
    "key1": "value1"
  }
}
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

定义

名称 说明
CloudError

来自服务的错误响应。

CloudErrorBody

来自服务的错误响应。

ProvisioningState

资源的预配状态。 这是一个只读属性,任何设置此值的尝试都将被忽略。

SubResource

对另一个子资源的引用。

VirtualNetworkLink

描述指向专用 DNS区域的虚拟网络的链接。

VirtualNetworkLinkState

指向专用 DNS区域的虚拟网络链接的状态。 可能的值为“InProgress”和“Done”。 这是一个只读属性,任何设置此值的尝试都将被忽略。

CloudError

来自服务的错误响应。

名称 类型 说明
error

CloudErrorBody

云错误正文。

CloudErrorBody

来自服务的错误响应。

名称 类型 说明
code

string

错误的标识符。 代码是固定的,旨在以编程方式使用。

details

CloudErrorBody[]

有关错误的其他详细信息的列表。

message

string

描述错误的消息,该消息适用于在用户界面中显示。

target

string

特定错误的目标。 例如,属性的名称出错。

ProvisioningState

资源的预配状态。 这是一个只读属性,任何设置此值的尝试都将被忽略。

名称 类型 说明
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

SubResource

对另一个子资源的引用。

名称 类型 说明
id

string

资源 ID。

描述指向专用 DNS区域的虚拟网络的链接。

名称 类型 说明
etag

string

虚拟网络链接的 ETag。

id

string

资源的完全限定资源 ID。 示例 - “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}”。

location

string

资源所在的 Azure 区域

name

string

资源的名称

properties.provisioningState

ProvisioningState

资源的预配状态。 这是一个只读属性,任何设置此值的尝试都将被忽略。

properties.registrationEnabled

boolean

是否已启用专用 DNS区域中虚拟网络中的虚拟机记录自动注册?

properties.virtualNetwork

SubResource

虚拟网络的引用。

properties.virtualNetworkLinkState

VirtualNetworkLinkState

指向专用 DNS区域的虚拟网络链接的状态。 可能的值为“InProgress”和“Done”。 这是一个只读属性,任何设置此值的尝试都将被忽略。

tags

object

资源标记。

type

string

资源类型。 示例 - “Microsoft.Network/privateDnsZones”。

VirtualNetworkLinkState

指向专用 DNS区域的虚拟网络链接的状态。 可能的值为“InProgress”和“Done”。 这是一个只读属性,任何设置此值的尝试都将被忽略。

名称 类型 说明
Completed

string

InProgress

string