共用方式為


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 模式: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Azure 訂用帳戶標識碼

Regex 模式: ^[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

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
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"
}

定義

名稱 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