Jit Network Access Policies - Create Or Update

使用 Just-In-Time 訪問控制建立保護資源的原則

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/jitNetworkAccessPolicies/{jitNetworkAccessPolicyName}?api-version=2020-01-01

URI 參數

名稱 位於 必要 類型 Description
ascLocation
path True

string

ASC 儲存訂閱數據的位置。 可以從取得位置擷取

jitNetworkAccessPolicyName
path True

string

Just-In-Time 存取設定原則的名稱。

resourceGroupName
path True

string

用戶訂用帳戶內的資源組名。 名稱不區分大小寫。

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Azure 訂用帳戶識別碼

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

作業的 API 版本

要求本文

名稱 必要 類型 Description
properties.virtualMachines True

JitNetworkAccessPolicyVirtualMachine[]

Microsoft.Compute/virtualMachines 資源類型的組態。

kind

string

資源的種類

properties.requests

JitNetworkAccessRequest[]

回應

名稱 類型 Description
200 OK

JitNetworkAccessPolicy

確定

Other Status Codes

CloudError

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Create JIT network access policy

Sample Request

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

Sample Response

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

定義

名稱 Description
CloudError

所有 Azure Resource Manager API 的常見錯誤回應,以傳回失敗作業的錯誤詳細數據。 (這也會遵循 OData 錯誤回應格式。) 。

CloudErrorBody

錯誤詳細數據。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

JitNetworkAccessPolicy
JitNetworkAccessPolicyVirtualMachine
JitNetworkAccessPortRule
JitNetworkAccessRequest
JitNetworkAccessRequestPort
JitNetworkAccessRequestVirtualMachine
protocol
status

埠的狀態

statusReason

為何 status 具有其值的描述

CloudError

所有 Azure Resource Manager API 的常見錯誤回應,以傳回失敗作業的錯誤詳細數據。 (這也會遵循 OData 錯誤回應格式。) 。

名稱 類型 Description
error.additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

error.code

string

錯誤碼。

error.details

CloudErrorBody[]

錯誤詳細資料。

error.message

string

錯誤訊息。

error.target

string

錯誤目標。

CloudErrorBody

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

CloudErrorBody[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

JitNetworkAccessPolicy

名稱 類型 Description
id

string

資源標識碼

kind

string

資源的種類

location

string

儲存資源的位置

name

string

資源名稱

properties.provisioningState

string

取得 Just-In-Time 原則的布建狀態。

properties.requests

JitNetworkAccessRequest[]

properties.virtualMachines

JitNetworkAccessPolicyVirtualMachine[]

Microsoft.Compute/virtualMachines 資源類型的組態。

type

string

資源類型

JitNetworkAccessPolicyVirtualMachine

名稱 類型 Description
id

string

連結至此原則之虛擬機的資源標識碼

ports

JitNetworkAccessPortRule[]

虛擬機的埠設定

publicIpAddress

string

如果適用,則連結至此原則之 Azure 防火牆 的公用IP位址

JitNetworkAccessPortRule

名稱 類型 Description
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

名稱 類型 Description
justification

string

提出起始要求的理由

requestor

string

提出要求的人員身分識別

startTimeUtc

string

以UTC為單位的要求開始時間

virtualMachines

JitNetworkAccessRequestVirtualMachine[]

JitNetworkAccessRequestPort

名稱 類型 Description
allowedSourceAddressPrefix

string

與 「allowedSourceAddressPrefixes」 參數互斥。 應該是IP位址或 CIDR,例如 「192.168.0.3」 或 「192.168.0.0/16」。。

allowedSourceAddressPrefixes

string[]

與 「allowedSourceAddressPrefix」 參數互斥。

endTimeUtc

string

要求以 UTC 結束的日期 & 時間

mappedPort

integer

如果適用,則對應至 Azure 防火牆 中此埠的number

number

integer

status

status

埠的狀態

statusReason

statusReason

為何 status 具有其值的描述

JitNetworkAccessRequestVirtualMachine

名稱 類型 Description
id

string

連結至此原則之虛擬機的資源標識碼

ports

JitNetworkAccessRequestPort[]

為虛擬機開啟的埠

protocol

名稱 類型 Description
*

string

TCP

string

UDP

string

status

埠的狀態

名稱 類型 Description
Initiated

string

Revoked

string

statusReason

為何 status 具有其值的描述

名稱 類型 Description
Expired

string

NewerRequestInitiated

string

UserRequested

string