Network Watchers - Create Or Update
在指定的资源组中创建或更新网络观察程序。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}?api-version=2025-03-01
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
network
|
path | True |
string |
网络观察程序的名称。 |
|
resource
|
path | True |
string |
资源组的名称。 |
|
subscription
|
path | True |
string |
唯一标识 Azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。 |
|
api-version
|
query | True |
string |
客户端 API 版本。 |
请求正文
| 名称 | 类型 | 说明 |
|---|---|---|
| id |
string |
资源 ID。 |
| location |
string |
资源位置。 |
| tags |
object |
资源标记。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
更新成功。 该作返回生成的网络观察程序资源。 |
|
| 201 Created |
创造成功。 该作返回生成的网络观察程序资源。 |
|
| Other Status Codes |
描述作失败的原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
| 名称 | 说明 |
|---|---|
| user_impersonation | 模拟用户帐户 |
示例
Create network watcher
示例请求
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1?api-version=2025-03-01
{
"location": "eastus",
"properties": {}
}
示例响应
{
"name": "nw1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1",
"etag": "W/\"00000000-0000-0000-0000-000000000000\"",
"type": "Microsoft.Network/networkWatchers",
"location": "eastus",
"tags": {},
"properties": {
"provisioningState": "Succeeded"
}
}
{
"name": "nw1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1",
"etag": "W/\"00000000-0000-0000-0000-000000000000\"",
"type": "Microsoft.Network/networkWatchers",
"location": "eastus",
"tags": {},
"properties": {
"provisioningState": "Succeeded"
}
}
定义
| 名称 | 说明 |
|---|---|
|
Error |
常见的错误详细信息表示形式。 |
|
Error |
错误对象。 |
|
Network |
资源组中的网络观察程序。 |
|
Provisioning |
当前预配状态。 |
ErrorDetails
常见的错误详细信息表示形式。
| 名称 | 类型 | 说明 |
|---|---|---|
| code |
string |
错误代码。 |
| message |
string |
错误消息。 |
| target |
string |
错误目标。 |
ErrorResponse
错误对象。
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误 |
NetworkWatcher
资源组中的网络观察程序。
| 名称 | 类型 | 说明 |
|---|---|---|
| etag |
string |
一个唯一的只读字符串,每当更新资源时更改。 |
| id |
string |
资源 ID。 |
| location |
string |
资源位置。 |
| name |
string |
资源名称。 |
| properties.provisioningState |
网络观察程序资源的预配状态。 |
|
| tags |
object |
资源标记。 |
| type |
string |
资源类型。 |
ProvisioningState
当前预配状态。
| 值 | 说明 |
|---|---|
| Succeeded | |
| Updating | |
| Deleting | |
| Failed |