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

Security Admin Configurations - Create Or Update

创建或更新网络管理器安全管理员配置。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}?api-version=2024-05-01

URI 参数

名称 必需 类型 说明
configurationName
path True

string

网络管理器安全配置的名称。

networkManagerName
path True

string

pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$

网络管理器的名称。

resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

唯一标识 Azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。

api-version
query True

string

客户端 API 版本。

请求正文

名称 类型 说明
properties.applyOnNetworkIntentPolicyBasedServices

NetworkIntentPolicyBasedService[]

基于网络意向策略的服务的枚举列表。

properties.description

string

安全配置的说明。

properties.networkGroupAddressSpaceAggregationOption

AddressSpaceAggregationOption

确定此配置中规则中引用的网络组更改的更新行为。

响应

名称 类型 说明
200 OK

SecurityAdminConfiguration

更新了管理员配置

201 Created

SecurityAdminConfiguration

已创建管理员配置

Other Status Codes

CommonErrorResponse

描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Create manual-mode security admin configuration
Create network manager security admin configuration

Create manual-mode security admin configuration

示例请求

PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig?api-version=2024-05-01

{
  "properties": {
    "description": "A configuration which will update any network groups ip addresses at commit times.",
    "networkGroupAddressSpaceAggregationOption": "Manual"
  }
}

示例响应

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg1/providers/Microsoft.Network/networkManager/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig",
  "name": "myTestSecurityConfig",
  "type": "Microsoft.Network/networkManagers/securityAdminConfigurations",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "description": "A sample policy",
    "provisioningState": "Succeeded",
    "networkGroupAddressSpaceAggregationOption": "Manual"
  }
}
{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg1/providers/Microsoft.Network/networkManager/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig",
  "name": "myTestSecurityConfig",
  "type": "Microsoft.Network/networkManagers/securityAdminConfigurations",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "description": "A sample policy",
    "provisioningState": "Succeeded",
    "networkGroupAddressSpaceAggregationOption": "Manual"
  }
}

Create network manager security admin configuration

示例请求

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig?api-version=2024-05-01

{
  "properties": {
    "description": "A sample policy",
    "applyOnNetworkIntentPolicyBasedServices": [
      "None"
    ]
  }
}

示例响应

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManager/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig",
  "name": "myTestSecurityConfig",
  "type": "Microsoft.Network/networkManagers/securityAdminConfigurations",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "description": "A sample policy",
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-000000000000",
    "applyOnNetworkIntentPolicyBasedServices": [
      "None"
    ]
  }
}
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManager/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig",
  "name": "myTestSecurityConfig",
  "type": "Microsoft.Network/networkManagers/securityAdminConfigurations",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "description": "A sample policy",
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-000000000000",
    "applyOnNetworkIntentPolicyBasedServices": [
      "None"
    ]
  }
}

定义

名称 说明
AddressSpaceAggregationOption

指示在网络管理器配置中引用的资源地址前缀的更新行为的选项。

CommonErrorAdditionalInfo

资源管理错误附加信息。

CommonErrorDetail

错误详细信息。

CommonErrorResponse

错误响应

createdByType

创建资源的标识的类型。

NetworkIntentPolicyBasedService

基于网络意向策略的服务。

ProvisioningState

资源的预配状态。

SecurityAdminConfiguration

定义安全管理员配置

SystemData

与创建和上次修改资源相关的元数据。

AddressSpaceAggregationOption

指示在网络管理器配置中引用的资源地址前缀的更新行为的选项。

说明
Manual
None

CommonErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

CommonErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

CommonErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

CommonErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

CommonErrorResponse

错误响应

名称 类型 说明
error

CommonErrorDetail

错误对象。

createdByType

创建资源的标识的类型。

说明
Application
Key
ManagedIdentity
User

NetworkIntentPolicyBasedService

基于网络意向策略的服务。

说明
All
AllowRulesOnly
None

ProvisioningState

资源的预配状态。

说明
Canceled
Creating
Deleting
Failed
Succeeded
Updating

SecurityAdminConfiguration

定义安全管理员配置

名称 类型 说明
etag

string

一个唯一的只读字符串,每当更新资源时更改。

id

string

资源 ID。

name

string

资源名称。

properties.applyOnNetworkIntentPolicyBasedServices

NetworkIntentPolicyBasedService[]

基于网络意向策略的服务的枚举列表。

properties.description

string

安全配置的说明。

properties.networkGroupAddressSpaceAggregationOption

AddressSpaceAggregationOption

确定此配置中规则中引用的网络组更改的更新行为。

properties.provisioningState

ProvisioningState

资源的预配状态。

properties.resourceGuid

string

此资源的唯一标识符。

systemData

SystemData

与此资源相关的系统元数据。

type

string

资源类型。

SystemData

与创建和上次修改资源相关的元数据。

名称 类型 说明
createdAt

string (date-time)

资源创建时间戳(UTC)。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识的类型。

lastModifiedAt

string (date-time)

上次修改资源的标识的类型。

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识的类型。