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


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

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

string

Расположение, в котором ASC хранит данные подписки. можно получить из расположений Get

jitNetworkAccessPolicyName
path True

string

Имя политики конфигурации JIT-доступа.

resourceGroupName
path True

string

Имя группы ресурсов в подписке пользователя. Имя не учитывает регистр.

Шаблон регулярного выражения: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Идентификатор подписки Azure

Шаблон регулярного выражения: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

Версия API для операции

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

Имя Обязательно Тип Описание
properties.virtualMachines True

JitNetworkAccessPolicyVirtualMachine[]

Конфигурации для типа ресурса Microsoft.Compute/virtualMachines.

kind

string

Тип ресурса

properties.requests

JitNetworkAccessRequest[]

Ответы

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

JitNetworkAccessPolicy

ХОРОШО

Other Status Codes

CloudError

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

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

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"
}

Определения

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

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

CloudErrorBody

Сведения об ошибке.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

JitNetworkAccessPolicy
JitNetworkAccessPolicyVirtualMachine
JitNetworkAccessPortRule
JitNetworkAccessRequest
JitNetworkAccessRequestPort
JitNetworkAccessRequestVirtualMachine
protocol
status

Состояние порта

statusReason

Описание того, почему status имеет свое значение

CloudError

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

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

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

error.code

string

Код ошибки.

error.details

CloudErrorBody[]

Сведения об ошибке.

error.message

string

Сообщение об ошибке.

error.target

string

Целевой объект ошибки.

CloudErrorBody

Сведения об ошибке.

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

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

CloudErrorBody[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

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

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

JitNetworkAccessPolicy

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

string

Идентификатор ресурса

kind

string

Тип ресурса

location

string

Расположение, в котором хранится ресурс

name

string

Имя ресурса

properties.provisioningState

string

Возвращает состояние подготовки политики JIT.

properties.requests

JitNetworkAccessRequest[]

properties.virtualMachines

JitNetworkAccessPolicyVirtualMachine[]

Конфигурации для типа ресурса Microsoft.Compute/virtualMachines.

type

string

Тип ресурса

JitNetworkAccessPolicyVirtualMachine

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

string

Идентификатор ресурса виртуальной машины, связанной с этой политикой

ports

JitNetworkAccessPortRule[]

Конфигурации портов для виртуальной машины

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

protocol

JitNetworkAccessRequest

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

string

Обоснование выполнения запроса на инициирование

requestor

string

Удостоверение лица, который сделал запрос

startTimeUtc

string

Время начала запроса в формате UTC

virtualMachines

JitNetworkAccessRequestVirtualMachine[]

JitNetworkAccessRequestPort

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

string

Взаимоисключаемая с параметром "allowedSourceAddressPrefixes". Должен быть IP-адрес или CIDR, например "192.168.0.3" или "192.168.0.0/16".

allowedSourceAddressPrefixes

string[]

Взаимоисключаемая с параметром "allowedSourceAddressPrefix".

endTimeUtc

string

Дата & времени окончания запроса в формате UTC

mappedPort

integer

Порт, сопоставленный с number этого порта в брандмауэре Azure, если применимо

number

integer

status

status

Состояние порта

statusReason

statusReason

Описание того, почему status имеет свое значение

JitNetworkAccessRequestVirtualMachine

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

string

Идентификатор ресурса виртуальной машины, связанной с этой политикой

ports

JitNetworkAccessRequestPort[]

Порты, открытые для виртуальной машины

protocol

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

string

TCP

string

UDP

string

status

Состояние порта

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

string

Revoked

string

statusReason

Описание того, почему status имеет свое значение

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

string

NewerRequestInitiated

string

UserRequested

string