Jit Network Access Policies - Initiate

Hizmet:
Defender for Cloud
API Sürümü:
2015-06-01-preview

Belirli bir Tam Zamanında ilke yapılandırmasından JIT erişimi başlatın.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/jitNetworkAccessPolicies/{jitNetworkAccessPolicyName}/initiate?api-version=2015-06-01-preview

URI Parametreleri

Name İçinde Gerekli Tür Description
ascLocation
 path True

string

ASC'nin aboneliğin verilerini depoladığı konum. Get konumlarından alınabilir
jitNetworkAccessPolicyInitiateType
 path True

string

Tam Zamanında erişim ilkesinde yapılacak eylemin türü.
jitNetworkAccessPolicyName
 path True

string

Tam Zamanında erişim yapılandırma ilkesinin adı.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Kullanıcının aboneliğindeki kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId
 path True

string

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

Azure abonelik kimliği
api-version
 query True

string

İşlem için API sürümü

İstek Gövdesi

Name Gerekli Tür Description
virtualMachines True

JitNetworkAccessPolicyInitiateVirtualMachine[]

Erişimi açmak için bağlantı noktaları & sanal makinelerin listesi
justification

string

Başlatma isteğinde bulunmanın gerekçesi

Yanıtlar

Name Tür Description
202 Accepted

JitNetworkAccessRequest

Kabul
Other Status Codes

CloudError

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

Initiate an action on a JIT network access policy

Örnek isteği

POST https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default/initiate?api-version=2015-06-01-preview

{
  "virtualMachines": [
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
      "ports": [
        {
          "number": 3389,
          "duration": "PT1H",
          "allowedSourceAddressPrefix": "192.127.0.2"
        }
      ]
    }
  ],
  "justification": "testing a new version of the product"
}

Örnek yanıt

Durum kodu:
202 
{
  "virtualMachines": [
    {
      "id": "/subscriptions/3eeab341-f466-499c-a8be-85427e154baf/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
      "ports": [
        {
          "number": 3389,
          "allowedSourceAddressPrefix": "192.127.0.2",
          "endTimeUtc": "2018-07-12T09:53:03.3658798Z",
          "status": "Initiating",
          "statusReason": "UserRequested"
        }
      ]
    }
  ],
  "startTimeUtc": "2018-07-12T08:53:03.3658798Z",
  "requestor": "barbara@contoso.com",
  "justification": "testing a new version of the product"
}

Tanımlar

Name Description
CloudError

Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).
CloudErrorBody

Hata ayrıntısı.
ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.
JitNetworkAccessPolicyInitiatePort
JitNetworkAccessPolicyInitiateRequest
JitNetworkAccessPolicyInitiateVirtualMachine
JitNetworkAccessRequest
JitNetworkAccessRequestPort
JitNetworkAccessRequestVirtualMachine
status

Bağlantı noktasının durumu
statusReason

status değerinin neden olduğunu açıklayan açıklama

CloudError

Nesne

Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

Name Tür Description
error.additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.
error.code

string

Hata kodu.
error.details

CloudErrorBody[]

Hata ayrıntıları.
error.message

string

Hata iletisi.
error.target

string

Hata hedefi.

CloudErrorBody

Nesne

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.
code

string

Hata kodu.
details

CloudErrorBody[]

Hata ayrıntıları.
message

string

Hata iletisi.
target

string

Hata hedefi.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.
type

string

Ek bilgi türü.

JitNetworkAccessPolicyInitiatePort

Nesne
Name Tür Description
allowedSourceAddressPrefix

string

İzin verilen trafiğin kaynağı. Belirtilmezse, istek başlatma isteğinin kaynak IP adresi için olacaktır.
endTimeUtc

string (date-time)

İsteği UTC olarak kapatma süresi
number

integer

minimum: 0
maximum: 65535

JitNetworkAccessPolicyInitiateRequest

Nesne
Name Tür Description
justification

string

Başlatma isteğinde bulunmanın gerekçesi
virtualMachines

JitNetworkAccessPolicyInitiateVirtualMachine[]

Erişimi açmak için bağlantı noktaları & sanal makinelerin listesi

JitNetworkAccessPolicyInitiateVirtualMachine

Nesne
Name Tür Description
id

string

Bu ilkeye bağlı sanal makinenin kaynak kimliği
ports

JitNetworkAccessPolicyInitiatePort[]

id ile kaynak için açılacak bağlantı noktaları

JitNetworkAccessRequest

Nesne
Name Tür Description
justification

string

Başlatma isteğinde bulunmanın gerekçesi
requestor

string

İsteği yapan kişinin kimliği
startTimeUtc

string (date-time)

İsteğin UTC olarak başlangıç saati
virtualMachines

JitNetworkAccessRequestVirtualMachine[]

JitNetworkAccessRequestPort

Nesne
Name Tür Description
allowedSourceAddressPrefix

string

"allowedSourceAddressPrefixes" parametresiyle birbirini dışlar. "192.168.0.3" veya "192.168.0.0/16" gibi bir IP adresi veya CIDR olmalıdır.
allowedSourceAddressPrefixes

string[]

"allowedSourceAddressPrefix" parametresiyle birbirini dışlar.
endTimeUtc

string (date-time)

İsteğin UTC ile sona erdiği tarih & saat
mappedPort

integer

Varsa Azure Güvenlik Duvarı'nda bu bağlantı noktasının number eşlenen bağlantı noktası
number

integer

minimum: 0
maximum: 65535
status

status

Bağlantı noktasının durumu
statusReason

statusReason

status değerinin neden olduğunu açıklayan açıklama

JitNetworkAccessRequestVirtualMachine

Nesne
Name Tür Description
id

string

Bu ilkeye bağlı sanal makinenin kaynak kimliği
ports

JitNetworkAccessRequestPort[]

Sanal makine için açılan bağlantı noktaları

status

Numaralandırma

Bağlantı noktasının durumu

Değer Description
Revoked
Initiated

statusReason

Numaralandırma

status değerinin neden olduğunu açıklayan açıklama

Değer Description
Expired
UserRequested
NewerRequestInitiated