Lab Plans - Create Or Update

Laboratuvar Planı kaynağını Güncelleştirmeler veya oluşturur.
Laboratuvar Planı kaynağı oluşturma veya güncelleştirme işlemi.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labPlans/{labPlanName}?api-version=2022-08-01

URI Parametreleri

Name In Required Type Description
labPlanName
path True
  • string

İçeren kaynak grubu içinde bunu benzersiz olarak tanımlayan laboratuvar planının adı. Kaynak URI'lerinde ve kullanıcı arabiriminde kullanılır.

resourceGroupName
path True
  • string

Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.

subscriptionId
path True
  • string

Hedef aboneliğin kimliği.

api-version
query True
  • string

Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name Required Type Description
location True
  • string

Kaynağın bulunduğu coğrafi konum

identity

Yönetilen Kimlik Bilgileri

properties.allowedRegions
  • string[]

Laboratuvar oluşturucusunun bu laboratuvar planını kullanarak laboratuvar oluştururken kullanmasına izin verilen bölgeler.

properties.defaultAutoShutdownProfile

Varsayılan laboratuvar kapatma profili. Bu, laboratuvar kaynağında değiştirilebilir ve yalnızca varsayılan bir profil sağlar.

properties.defaultConnectionProfile

Varsayılan laboratuvar bağlantı profili. Bu, laboratuvar kaynağında değiştirilebilir ve yalnızca varsayılan bir profil sağlar.

properties.defaultNetworkProfile

Laboratuvar planı ağ profili. Laboratuvar ağ ilkelerini zorunlu kılmak için burada tanımlanmalıdır ve bu laboratuvar planıyla ilişkilendirilmiş mevcut laboratuvarlar olduğunda değiştirilemezler.

properties.linkedLmsInstance
  • string

Bu laboratuvar planının laboratuvar listelerini bağlayabileceğiniz lms örneğinin Temel Url'si.

properties.sharedGalleryId
  • string

Bu laboratuvar planına eklenen Paylaşılan Görüntü Galerisi kaynak kimliği. Laboratuvar şablonu sanal makine görüntüsü kaydedilirken bu galeride kalıcı hale gelecek. Galeriden paylaşılan görüntüler, yeni laboratuvarlar oluşturulurken kullanılabilir hale getirilebilir.

properties.supportInfo

Laboratuvar planı kullanıcıları için kişi bilgilerini ve yönergeleri destekleyin. Bu bilgiler laboratuvar planındaki tüm laboratuvarlar için laboratuvar sahiplerine ve sanal makine kullanıcılarına görüntülenir.

tags
  • object

Kaynak etiketleri.

Yanıtlar

Name Type Description
200 OK

Güncelleştirme başarılı oldu; yanıt, Laboratuvar Planını içerir.

201 Created

Oluşturma başarılı oldu; yanıt, Laboratuvar Planını içerir.

202 Accepted

Güncelleştirme başarılı oldu ve uzun süre çalışan bir işlemi var; yanıt, Laboratuvar Planını içerir.

Other Status Codes

Varsayılan hata yanıtı.

Örnekler

putLabPlan

Sample Request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan?api-version=2022-08-01

{
  "location": "westus",
  "properties": {
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}
Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Creating",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}
Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Updating",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}

Tanımlar

AutoShutdownProfile

Sanal makineleri kapatmanın nasıl işlendiğini gösteren profil.

ConnectionProfile

Kullanıcıların laboratuvar sanal makinelerine nasıl bağlanacaklarına ilişkin bağlantı profili.

ConnectionType

SSH üzerinden Web Erişimi için etkin erişim düzeyi.

createdByType

Kaynağı oluşturan kimliğin türü.

EnableState

Bağlantı kesildiğinde kapatmanın etkinleştirilip etkinleştirilmediği

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

Identity

Kaynağın kimliği.

LabPlan

Laboratuvar Planları, labs.azure.com aracılığıyla laboratuvar oluşturmak için bir izin kapsayıcısı görevi görür. Ayrıca, laboratuvar oluşturulurken uygulanacak bir dizi varsayılan yapılandırma sağlayabilirler, ancak bu varsayılanların üzerine yazılabilir.

LabPlanNetworkProfile

Laboratuvar Planları için ağ işleme profili.

ProvisioningState

Laboratuvar planının geçerli sağlama durumu.

ResourceIdentityType

Kimlik türü.

shutdownOnIdleMode

Boşta vm'nin kapatılıp kapatılmayacağını ve boşta algılama ölçütlerini tanımlar.

SupportInfo

Destek iletişim bilgileri ve yönergeleri.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

AutoShutdownProfile

Sanal makineleri kapatmanın nasıl işlendiğini gösteren profil.

Name Type Default Value Description
disconnectDelay
  • string

Bu davranış etkinleştirilirse, kullanıcı bağlantısını kestikten sonra VM'nin çalışmaya devam edeceği süre.

idleDelay
  • string

Bu davranış etkinse VM'nin kapanmadan önce boşta kalma süresi.

noConnectDelay
  • string

Bağlantı yapılmazsa ve bu davranış etkinse, vm'nin kapanmadan önce çalışmaya devam edeceği süre.

shutdownOnDisconnect Disabled

Bağlantı kesildiğinde kapatmanın etkinleştirilip etkinleştirilmediği

shutdownOnIdle None

Vm'nin belirli bir süre boşta kaldığında kapatılıp kapatılmayacağı.

shutdownWhenNotConnected Disabled

Vm'nin belirli bir süre sonra bağlanmadığında kapatılıp kapatılmayacağı.

ConnectionProfile

Kullanıcıların laboratuvar sanal makinelerine nasıl bağlanacaklarına ilişkin bağlantı profili.

Name Type Default Value Description
clientRdpAccess None

RDP üzerinden İstemci Erişimi için etkin erişim düzeyi.

clientSshAccess None

SSH üzerinden İstemci Erişimi için etkin erişim düzeyi.

webRdpAccess None

RDP üzerinden Web Erişimi için etkin erişim düzeyi.

webSshAccess None

SSH üzerinden Web Erişimi için etkin erişim düzeyi.

ConnectionType

SSH üzerinden Web Erişimi için etkin erişim düzeyi.

Name Type Description
None
  • string
Private
  • string
Public
  • string

createdByType

Kaynağı oluşturan kimliğin türü.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

EnableState

Bağlantı kesildiğinde kapatmanın etkinleştirilip etkinleştirilmediği

Name Type Description
Disabled
  • string
Enabled
  • string

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Type Description
info
  • object

Ek bilgiler.

type
  • string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Type Description
additionalInfo

Hata ek bilgileri.

code
  • string

Hata kodu.

details

Hata ayrıntıları.

message
  • string

Hata iletisi.

target
  • string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Type Description
error

Hata nesnesi.

Identity

Kaynağın kimliği.

Name Type Description
principalId
  • string

Kaynak kimliğinin asıl kimliği.

tenantId
  • string

Kaynağın kiracı kimliği.

type

Kimlik türü.

LabPlan

Laboratuvar Planları, labs.azure.com aracılığıyla laboratuvar oluşturmak için bir izin kapsayıcısı görevi görür. Ayrıca, laboratuvar oluşturulurken uygulanacak bir dizi varsayılan yapılandırma sağlayabilirler, ancak bu varsayılanların üzerine yazılabilir.

Name Type Description
id
  • string

Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Yönetilen Kimlik Bilgileri

location
  • string

Kaynağın bulunduğu coğrafi konum

name
  • string

Kaynağın adı

properties.allowedRegions
  • string[]

Laboratuvar oluşturucusunun bu laboratuvar planını kullanarak laboratuvar oluştururken kullanmasına izin verilen bölgeler.

properties.defaultAutoShutdownProfile

Varsayılan laboratuvar kapatma profili. Bu, laboratuvar kaynağında değiştirilebilir ve yalnızca varsayılan bir profil sağlar.

properties.defaultConnectionProfile

Varsayılan laboratuvar bağlantı profili. Bu, laboratuvar kaynağında değiştirilebilir ve yalnızca varsayılan bir profil sağlar.

properties.defaultNetworkProfile

Laboratuvar planı ağ profili. Laboratuvar ağ ilkelerini zorunlu kılmak için burada tanımlanmalıdır ve bu laboratuvar planıyla ilişkilendirilmiş mevcut laboratuvarlar olduğunda değiştirilemezler.

properties.linkedLmsInstance
  • string

Bu laboratuvar planının laboratuvar listelerini birbirine bağlayabileceğiniz lms örneğinin temel Url'si.

properties.provisioningState

Laboratuvar planının geçerli sağlama durumu.

properties.sharedGalleryId
  • string

Bu laboratuvar planına eklenen Paylaşılan Görüntü Galerisi kaynak kimliği. Laboratuvar şablonu sanal makine görüntüsü kaydedilirken bu galeride kalıcı hale gelecek. Galeriden paylaşılan görüntüler, yeni laboratuvarlar oluşturulurken kullanılabilir hale getirilebilir.

properties.supportInfo

Laboratuvar planı kullanıcıları için kişi bilgilerini ve yönergeleri destekleyin. Bu bilgiler laboratuvar planındaki tüm laboratuvarlar için laboratuvar sahiplerine ve sanal makine kullanıcılarına görüntülenir.

systemData

Laboratuvar planının oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

tags
  • object

Kaynak etiketleri.

type
  • string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

LabPlanNetworkProfile

Laboratuvar Planları için ağ işleme profili.

Name Type Description
subnetId
  • string

Dış alt ağ kaynak kimliği

ProvisioningState

Laboratuvar planının geçerli sağlama durumu.

Name Type Description
Creating
  • string

Kaynak oluşturulma aşamasındadır.

Deleting
  • string

Kaynak silinme aşamasında.

Failed
  • string

Kaynaktaki önceki işlem, kaynağı iyi durumda bırakmada başarısız oldu.

Locked
  • string

Kaynak kilitli ve değişiklikler şu anda engelleniyor. Bunun nedeni bakım veya zamanlanmış bir işlem olabilir. Kilitleme işlemi tamamlandıktan sonra durum başarılı durumuna geri döner.

Succeeded
  • string

Kaynak oluşturma veya güncelleştirme işleminden sonra iyi durumda.

Updating
  • string

Kaynağa yeni özellik değerleri uygulanıyor.

ResourceIdentityType

Kimlik türü.

Name Type Description
SystemAssigned
  • string

shutdownOnIdleMode

Boşta vm'nin kapatılıp kapatılmayacağını ve boşta algılama ölçütlerini tanımlar.

Name Type Description
LowUsage
  • string

Kullanıcı olmadığında ve kaynak (CPU ve disk) tüketimi düşük olduğunda VM boşta olarak kabul edilir.

None
  • string

Vm boşta olduğunda kapatılamaz.

UserAbsence
  • string

Klavye veya fare girişi olmadığında VM boşta olarak kabul edilir.

SupportInfo

Destek iletişim bilgileri ve yönergeleri.

Name Type Description
email
  • string

Destek iletişim e-posta adresi.

instructions
  • string

Destek yönergeleri.

phone
  • string

Destek iletişim telefon numarası.

url
  • string

Destek web adresi.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Type Description
createdAt
  • string

Kaynak oluşturma (UTC) zaman damgası.

createdBy
  • string

Kaynağı oluşturan kimlik.

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt
  • string

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy
  • string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

Kaynağı en son değiştiren kimliğin türü.