Jit Network Access Policies - Create Or Update
Создание политики защиты ресурсов с помощью JIT-управления доступом
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/jitNetworkAccessPolicies/{jitNetworkAccessPolicyName}?api-version=2020-01-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
asc
|
path | True |
string |
Расположение, в котором ASC хранит данные подписки. можно получить из расположений Get |
jit
|
path | True |
string |
Имя политики конфигурации JIT-доступа. |
resource
|
path | True |
string |
Имя группы ресурсов в подписке пользователя. Имя не учитывает регистр. Шаблон регулярного выражения: |
subscription
|
path | True |
string |
Идентификатор подписки Azure Шаблон регулярного выражения: |
api-version
|
query | True |
string |
Версия API для операции |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
properties.virtualMachines | True |
Конфигурации для типа ресурса Microsoft.Compute/virtualMachines. |
|
kind |
string |
Тип ресурса |
|
properties.requests |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ХОРОШО |
|
Other Status Codes |
Ответ на ошибку, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
Create JIT network access policy
Образец запроса
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default?api-version=2020-01-01
{
"kind": "Basic",
"properties": {
"virtualMachines": [
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
"ports": [
{
"number": 22,
"protocol": "*",
"allowedSourceAddressPrefix": "*",
"maxRequestAccessDuration": "PT3H"
},
{
"number": 3389,
"protocol": "*",
"allowedSourceAddressPrefix": "*",
"maxRequestAccessDuration": "PT3H"
}
]
}
],
"requests": [
{
"virtualMachines": [
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
"ports": [
{
"number": 3389,
"allowedSourceAddressPrefix": "192.127.0.2",
"endTimeUtc": "2018-05-17T09:06:45.5691611Z",
"status": "Initiated",
"statusReason": "UserRequested"
}
]
}
],
"startTimeUtc": "2018-05-17T08:06:45.5691611Z",
"requestor": "barbara@contoso.com"
}
],
"provisioningState": "Succeeded"
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
"name": "default",
"type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
"location": "westeurope"
}
Пример ответа
{
"kind": "Basic",
"properties": {
"virtualMachines": [
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
"ports": [
{
"number": 22,
"protocol": "*",
"allowedSourceAddressPrefix": "*",
"maxRequestAccessDuration": "PT3H"
},
{
"number": 3389,
"protocol": "*",
"allowedSourceAddressPrefix": "*",
"maxRequestAccessDuration": "PT3H"
}
]
}
],
"requests": [
{
"virtualMachines": [
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
"ports": [
{
"number": 3389,
"allowedSourceAddressPrefix": "192.127.0.2",
"endTimeUtc": "2018-05-17T09:06:45.5691611Z",
"status": "Initiated",
"statusReason": "UserRequested"
}
]
}
],
"startTimeUtc": "2018-05-17T08:06:45.5691611Z",
"requestor": "barbara@contoso.com"
}
],
"provisioningState": "Succeeded"
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
"name": "default",
"type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
"location": "westeurope"
}
Определения
Имя | Описание |
---|---|
Cloud |
Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.). |
Cloud |
Сведения об ошибке. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Jit |
|
Jit |
|
Jit |
|
Jit |
|
Jit |
|
Jit |
|
protocol | |
status |
Состояние порта |
status |
Описание того, почему |
CloudError
Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).
Имя | Тип | Описание |
---|---|---|
error.additionalInfo |
Дополнительные сведения об ошибке. |
|
error.code |
string |
Код ошибки. |
error.details |
Сведения об ошибке. |
|
error.message |
string |
Сообщение об ошибке. |
error.target |
string |
Целевой объект ошибки. |
CloudErrorBody
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Дополнительный тип сведений. |
JitNetworkAccessPolicy
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса |
kind |
string |
Тип ресурса |
location |
string |
Расположение, в котором хранится ресурс |
name |
string |
Имя ресурса |
properties.provisioningState |
string |
Возвращает состояние подготовки политики JIT. |
properties.requests | ||
properties.virtualMachines |
Конфигурации для типа ресурса Microsoft.Compute/virtualMachines. |
|
type |
string |
Тип ресурса |
JitNetworkAccessPolicyVirtualMachine
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса виртуальной машины, связанной с этой политикой |
ports |
Конфигурации портов для виртуальной машины |
|
publicIpAddress |
string |
Общедоступный IP-адрес брандмауэра Azure, связанного с этой политикой, если применимо |
JitNetworkAccessPortRule
Имя | Тип | Описание |
---|---|---|
allowedSourceAddressPrefix |
string |
Взаимоисключаемая с параметром "allowedSourceAddressPrefixes". Должен быть IP-адрес или CIDR, например "192.168.0.3" или "192.168.0.0/16". |
allowedSourceAddressPrefixes |
string[] |
Взаимоисключаемая с параметром "allowedSourceAddressPrefix". |
maxRequestAccessDuration |
string |
Можно выполнять запросы на максимальную длительность. В формате длительности ISO 8601. Минимум 5 минут, максимум 1 день |
number |
integer |
|
protocol |
JitNetworkAccessRequest
Имя | Тип | Описание |
---|---|---|
justification |
string |
Обоснование выполнения запроса на инициирование |
requestor |
string |
Удостоверение лица, который сделал запрос |
startTimeUtc |
string |
Время начала запроса в формате UTC |
virtualMachines |
JitNetworkAccessRequestPort
Имя | Тип | Описание |
---|---|---|
allowedSourceAddressPrefix |
string |
Взаимоисключаемая с параметром "allowedSourceAddressPrefixes". Должен быть IP-адрес или CIDR, например "192.168.0.3" или "192.168.0.0/16". |
allowedSourceAddressPrefixes |
string[] |
Взаимоисключаемая с параметром "allowedSourceAddressPrefix". |
endTimeUtc |
string |
Дата & времени окончания запроса в формате UTC |
mappedPort |
integer |
Порт, сопоставленный с |
number |
integer |
|
status |
Состояние порта |
|
statusReason |
Описание того, почему |
JitNetworkAccessRequestVirtualMachine
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса виртуальной машины, связанной с этой политикой |
ports |
Порты, открытые для виртуальной машины |
protocol
Имя | Тип | Описание |
---|---|---|
* |
string |
|
TCP |
string |
|
UDP |
string |
status
Состояние порта
Имя | Тип | Описание |
---|---|---|
Initiated |
string |
|
Revoked |
string |
statusReason
Описание того, почему status
имеет свое значение
Имя | Тип | Описание |
---|---|---|
Expired |
string |
|
NewerRequestInitiated |
string |
|
UserRequested |
string |