Поделиться через

Nsp Access Rules - Create Or Update

  • Ссылка
Служба:
Network Manager
Версия API:
2023-07-01-preview

Создает или обновляет правило доступа к сети.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}/accessRules/{accessRuleName}?api-version=2023-07-01-preview

Параметры URI

Имя В Обязательно Тип Описание
accessRuleName
 path True

string

Имя правила доступа NSP.
networkSecurityPerimeterName
 path True

string

Имя периметра безопасности сети.
profileName
 path True

string

Имя профиля NSP.
resourceGroupName
 path True

string

Имя группы ресурсов.
subscriptionId
 path True

string

Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.
api-version
 query True

string

Версия КЛИЕНТСКОго API.

Текст запроса

Имя Тип Описание
location

string

Расположение ресурса.
name

string

Имя правила доступа, уникального в профиле. Это имя можно использовать для доступа к ресурсу.
properties.addressPrefixes

string[]

Префиксы входящих адресов (IPv4/IPv6)
properties.direction

AccessRuleDirection

Направление, указывающее, являются ли правила доступа входящими и исходящими.
properties.emailAddresses

string[]

Формат адреса электронной почты для правил исходящего трафика.
properties.fullyQualifiedDomainNames

string[]

Полный формат доменного имени для правил исходящего трафика.
properties.phoneNumbers

string[]

Формат номера телефона для исходящего трафика.
properties.subscriptions

SubscriptionId[]

Список идентификаторов подписки
tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

NspAccessRule

Обновлено — обновляется существующее правило доступа. Возвращает ресурс.
201 Created

NspAccessRule

Create — возвращает созданный ресурс NspAccessRule.
Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

NspAccessRulePut

Образец запроса

PUT https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1?api-version=2023-07-01-preview

{
  "properties": {
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ]
  }
}

Пример ответа

Код состояния:
200 
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": []
  }
}
Код состояния:
201 
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": []
  }
}

Определения

Имя Описание
AccessRuleDirection

Направление, указывающее, являются ли правила доступа входящими и исходящими.
CloudError

Ответ на ошибку службы.
CloudErrorBody

Ответ на ошибку службы.
NspAccessRule

Ресурс правила доступа NSP
nspProvisioningState

Состояние подготовки ресурса назначения области.
PerimeterBasedAccessRule
SubscriptionId

AccessRuleDirection

Перечисление

Направление, указывающее, являются ли правила доступа входящими и исходящими.

Значение Описание
Inbound
Outbound

CloudError

Object

Ответ на ошибку службы.

Имя Тип Описание
error

CloudErrorBody

Текст ошибки облака.

CloudErrorBody

Object

Ответ на ошибку службы.

Имя Тип Описание
code

string

Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
details

CloudErrorBody[]

Список дополнительных сведений об ошибке.
message

string

Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target

string

Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

NspAccessRule

Object

Ресурс правила доступа NSP

Имя Тип Описание
id

string

Идентификатор правила доступа NSP.
location

string

Расположение ресурса.
name

string

Имя правила доступа, уникального в профиле. Это имя можно использовать для доступа к ресурсу.
properties.addressPrefixes

string[]

Префиксы входящих адресов (IPv4/IPv6)
properties.direction

AccessRuleDirection

Направление, указывающее, являются ли правила доступа входящими и исходящими.
properties.emailAddresses

string[]

Формат адреса электронной почты для правил исходящего трафика.
properties.fullyQualifiedDomainNames

string[]

Полный формат доменного имени для правил исходящего трафика.
properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Правило, указанное идентификатором периметра.
properties.phoneNumbers

string[]

Формат номера телефона для исходящего трафика.
properties.provisioningState

nspProvisioningState

Состояние подготовки ресурса назначения области.
properties.subscriptions

SubscriptionId[]

Список идентификаторов подписки
tags

object

Теги ресурсов.
type

string

Тип ресурса.

nspProvisioningState

Перечисление

Состояние подготовки ресурса назначения области.

Значение Описание
Accepted
Creating
Deleting
Failed
Succeeded
Updating

PerimeterBasedAccessRule

Object
Имя Тип Описание
id

string

Идентификатор NSP в формате идентификатора ARM.
location

string

Расположение предоставленного NSP.
perimeterGuid

string

Guid ресурса предоставленного NSP.

SubscriptionId

Object
Имя Тип Описание
id

string

Идентификатор подписки в формате идентификатора ARM.