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 |
---|---|---|---|---|
asc
|
path | True |
string |
ASC 儲存訂閱數據的位置。 可以從取得位置擷取 |
jit
|
path | True |
string |
Just-In-Time 存取設定原則的名稱。 |
resource
|
path | True |
string |
用戶訂用帳戶內的資源組名。 名稱不區分大小寫。 Regex 模式: |
subscription
|
path | True |
string |
Azure 訂用帳戶標識碼 Regex 模式: |
api-version
|
query | True |
string |
作業的 API 版本 |
要求本文
名稱 | 必要 | 類型 | Description |
---|---|---|---|
properties.virtualMachines | True |
Microsoft.Compute/virtualMachines 資源類型的組態。 |
|
kind |
string |
資源的種類 |
|
properties.requests |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
還行 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
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 |
---|---|
Cloud |
所有 Azure Resource Manager API 的常見錯誤回應,以傳回失敗作業的錯誤詳細數據。 (這也遵循 OData 錯誤回應格式。)。 |
Cloud |
錯誤詳細數據。 |
Error |
資源管理錯誤其他資訊。 |
Jit |
|
Jit |
|
Jit |
|
Jit |
|
Jit |
|
Jit |
|
protocol | |
status |
埠的狀態 |
status |
說明 |
CloudError
所有 Azure Resource Manager API 的常見錯誤回應,以傳回失敗作業的錯誤詳細數據。 (這也遵循 OData 錯誤回應格式。)。
名稱 | 類型 | Description |
---|---|---|
error.additionalInfo |
錯誤其他資訊。 |
|
error.code |
string |
錯誤碼。 |
error.details |
錯誤詳細數據。 |
|
error.message |
string |
錯誤訊息。 |
error.target |
string |
錯誤目標。 |
CloudErrorBody
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細數據。 |
|
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 | ||
properties.virtualMachines |
Microsoft.Compute/virtualMachines 資源類型的組態。 |
|
type |
string |
資源類型 |
JitNetworkAccessPolicyVirtualMachine
名稱 | 類型 | Description |
---|---|---|
id |
string |
連結至此原則之虛擬機的資源標識碼 |
ports |
虛擬機的埠設定 |
|
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 |
JitNetworkAccessRequest
名稱 | 類型 | Description |
---|---|---|
justification |
string |
提出起始要求的理由 |
requestor |
string |
提出要求的人員身分識別 |
startTimeUtc |
string |
要求以UTC為單位的開始時間 |
virtualMachines |
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 |
integer |
|
status |
埠的狀態 |
|
statusReason |
說明 |
JitNetworkAccessRequestVirtualMachine
名稱 | 類型 | Description |
---|---|---|
id |
string |
連結至此原則之虛擬機的資源標識碼 |
ports |
為虛擬機開啟的埠 |
protocol
名稱 | 類型 | Description |
---|---|---|
* |
string |
|
TCP |
string |
|
UDP |
string |
status
埠的狀態
名稱 | 類型 | Description |
---|---|---|
Initiated |
string |
|
Revoked |
string |
statusReason
說明 status
為何具有其值
名稱 | 類型 | Description |
---|---|---|
Expired |
string |
|
NewerRequestInitiated |
string |
|
UserRequested |
string |