Sdílet prostřednictvím


Lab Plans - Create Or Update

Aktualizace nebo vytvoří prostředek plánu testovacího prostředí.
Operace pro vytvoření nebo aktualizaci prostředku plánu testovacího prostředí

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
labPlanName
path True

string

Název plánu testovacího prostředí, který ho jednoznačně identifikuje v rámci obsahující skupiny prostředků. Používá se v identifikátorech URI prostředků a v uživatelském rozhraní.

resourceGroupName
path True

string

Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.

subscriptionId
path True

string

ID cílového předplatného.

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Vyžadováno Typ Description
location True

string

Geografické umístění, kde se prostředek nachází

identity

Identity

Informace o spravované identitě

properties.allowedRegions

string[]

Povolené oblasti, které může tvůrce testovacího prostředí použít při vytváření testovacích prostředí pomocí tohoto plánu testovacího prostředí.

properties.defaultAutoShutdownProfile

AutoShutdownProfile

Výchozí profil vypnutí testovacího prostředí. To je možné změnit u prostředku testovacího prostředí a poskytuje pouze výchozí profil.

properties.defaultConnectionProfile

ConnectionProfile

Výchozí profil připojení k testovacímu prostředí To je možné změnit u prostředku testovacího prostředí a poskytuje pouze výchozí profil.

properties.defaultNetworkProfile

LabPlanNetworkProfile

Profil sítě plánu testovacího prostředí. Pokud chcete vynutit zásady sítě testovacího prostředí, musí být tady definované a nelze je změnit, pokud jsou k tomuto plánu testovacího prostředí přidružená existující testovací prostředí.

properties.linkedLmsInstance

string

Základní adresa URL instance LMS může tento plán testovacího prostředí propojit seznam testovacích prostředí.

properties.sharedGalleryId

string

ID prostředku Shared Image Gallery připojené k tomuto plánu testovacího prostředí. Při ukládání image virtuálního počítače šablony testovacího prostředí se uloží do této galerie. Sdílené image z galerie je možné zpřístupnit k použití při vytváření nových testovacích prostředí.

properties.supportInfo

SupportInfo

Kontaktní informace podpory a pokyny pro uživatele plánu testovacího prostředí Tyto informace se zobrazí vlastníkům testovacího prostředí a uživatelům virtuálních počítačů pro všechna testovací prostředí v plánu testovacího prostředí.

tags

object

Značky prostředků.

Odpovědi

Name Typ Description
200 OK

LabPlan

Aktualizace proběhla úspěšně. Odpověď obsahuje plán testovacího prostředí.

201 Created

LabPlan

Vytvoření proběhlo úspěšně. Odpověď obsahuje plán testovacího prostředí.

202 Accepted

LabPlan

Aktualizace byla úspěšná a má dlouhotrvající operaci. Odpověď obsahuje plán testovacího prostředí.

Other Status Codes

ErrorResponse

Výchozí chybová odpověď.

Příklady

putLabPlan

Ukázkový požadavek

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

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

Ukázková odpověď

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

Definice

Name Description
AutoShutdownProfile

Profil pro zpracování vypínání virtuálních počítačů

ConnectionProfile

Profil připojení pro způsob, jakým se uživatelé připojují k virtuálním počítačům testovacího prostředí.

ConnectionType

Povolená úroveň přístupu pro Webový přístup přes SSH.

createdByType

Typ identity, která prostředek vytvořila.

EnableState

Jestli je povolené vypnutí při odpojení

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě

ErrorResponse

Chybová odpověď

Identity

Identita prostředku.

LabPlan

Plány testovacího prostředí fungují jako kontejner oprávnění pro vytváření testovacích prostředí prostřednictvím labs.azure.com. Kromě toho můžou poskytnout sadu výchozích konfigurací, které se použijí při vytváření testovacího prostředí, ale tyto výchozí hodnoty se dají přepsat.

LabPlanNetworkProfile

Profil pro zpracování sítí pro plány testovacího prostředí

ProvisioningState

Aktuální stav zřizování plánu testovacího prostředí

ResourceIdentityType

Typ identity.

ResourceOperationError

Podrobnosti o chybě posledního selhání operace u tohoto prostředku

shutdownOnIdleMode

Definuje, jestli se má virtuální počítač vypnout při nečinnosti, a kritéria pro detekci nečinnosti.

SupportInfo

Kontaktní informace a pokyny pro podporu

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

AutoShutdownProfile

Profil pro zpracování vypínání virtuálních počítačů

Name Typ Default value Description
disconnectDelay

string

Doba, po kterou virtuální počítač zůstane spuštěný po odpojení uživatele, pokud je toto chování povolené.

idleDelay

string

Doba, po kterou bude virtuální počítač nečinný před vypnutím, pokud je toto chování povolené.

noConnectDelay

string

Doba, po kterou virtuální počítač zůstane spuštěný, než se vypne, pokud se nepřipojí a toto chování je povolené.

shutdownOnDisconnect

EnableState

Disabled

Jestli je povolené vypnutí při odpojení

shutdownOnIdle

shutdownOnIdleMode

None

Určuje, jestli se virtuální počítač po určité době vypne, když bude nečinný.

shutdownWhenNotConnected

EnableState

Disabled

Určuje, jestli se virtuální počítač vypne, když se po určité době nepřipojí.

ConnectionProfile

Profil připojení pro způsob, jakým se uživatelé připojují k virtuálním počítačům testovacího prostředí.

Name Typ Default value Description
clientRdpAccess

ConnectionType

None

Povolená úroveň přístupu pro klientský přístup přes protokol RDP.

clientSshAccess

ConnectionType

None

Povolená úroveň přístupu pro klientský přístup přes SSH.

webRdpAccess

ConnectionType

None

Povolená úroveň přístupu pro webový přístup přes protokol RDP.

webSshAccess

ConnectionType

None

Povolená úroveň přístupu pro Webový přístup přes SSH.

ConnectionType

Povolená úroveň přístupu pro Webový přístup přes SSH.

Name Typ Description
None

string

Private

string

Public

string

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

EnableState

Jestli je povolené vypnutí při odpojení

Name Typ Description
Disabled

string

Enabled

string

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Typ další informace.

ErrorDetail

Podrobnosti o chybě

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

Identity

Identita prostředku.

Name Typ Description
principalId

string

ID objektu zabezpečení identity prostředku.

tenantId

string

ID tenanta prostředku.

type

ResourceIdentityType

Typ identity.

LabPlan

Plány testovacího prostředí fungují jako kontejner oprávnění pro vytváření testovacích prostředí prostřednictvím labs.azure.com. Kromě toho můžou poskytnout sadu výchozích konfigurací, které se použijí při vytváření testovacího prostředí, ale tyto výchozí hodnoty se dají přepsat.

Name Typ Description
id

string

Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}

identity

Identity

Informace o spravované identitě

location

string

Geografické umístění, kde se prostředek nachází

name

string

Název prostředku

properties.allowedRegions

string[]

Povolené oblasti, které může tvůrce testovacího prostředí použít při vytváření testovacích prostředí pomocí tohoto plánu testovacího prostředí.

properties.defaultAutoShutdownProfile

AutoShutdownProfile

Výchozí profil vypnutí testovacího prostředí. To je možné změnit u prostředku testovacího prostředí a poskytuje pouze výchozí profil.

properties.defaultConnectionProfile

ConnectionProfile

Výchozí profil připojení k testovacímu prostředí To je možné změnit u prostředku testovacího prostředí a poskytuje pouze výchozí profil.

properties.defaultNetworkProfile

LabPlanNetworkProfile

Profil sítě plánu testovacího prostředí. Pokud chcete vynutit zásady sítě testovacího prostředí, musí být tady definované a nelze je změnit, pokud jsou k tomuto plánu testovacího prostředí přidružená existující testovací prostředí.

properties.linkedLmsInstance

string

Základní adresa URL instance LMS může tento plán testovacího prostředí propojit seznam testovacích prostředí.

properties.provisioningState

ProvisioningState

Aktuální stav zřizování plánu testovacího prostředí

properties.resourceOperationError

ResourceOperationError

Podrobnosti o chybě poslední operace provedené v plánu testovacího prostředí

properties.sharedGalleryId

string

ID prostředku Shared Image Gallery připojené k tomuto plánu testovacího prostředí. Při ukládání image virtuálního počítače šablony testovacího prostředí se uloží do této galerie. Sdílené image z galerie je možné zpřístupnit k použití při vytváření nových testovacích prostředí.

properties.supportInfo

SupportInfo

Kontaktní informace podpory a pokyny pro uživatele plánu testovacího prostředí Tyto informace se zobrazí vlastníkům testovacího prostředí a uživatelům virtuálních počítačů pro všechna testovací prostředí v plánu testovacího prostředí.

systemData

systemData

Metadata týkající se vytvoření a poslední změny plánu testovacího prostředí

tags

object

Značky prostředků.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

LabPlanNetworkProfile

Profil pro zpracování sítí pro plány testovacího prostředí

Name Typ Description
subnetId

string

ID prostředku externí podsítě

ProvisioningState

Aktuální stav zřizování plánu testovacího prostředí

Name Typ Description
Creating

string

Prostředek se právě vytváří.

Deleting

string

Prostředek se právě odstraňuje.

Failed

string

Předchozí operace s prostředkem selhala, takže prostředek není v pořádku.

Locked

string

Prostředek je uzamčený a změny jsou aktuálně blokované. Důvodem může být údržba nebo plánovaná operace. Jakmile se operace uzamčení dokončí, stav se vrátí zpět do úspěšného stavu.

Succeeded

string

Prostředek je po operaci vytvoření nebo aktualizace v pořádku.

Updating

string

Na prostředek se použijí nové hodnoty vlastností.

ResourceIdentityType

Typ identity.

Name Typ Description
SystemAssigned

string

ResourceOperationError

Podrobnosti o chybě posledního selhání operace u tohoto prostředku

Name Typ Description
action

string

Akce operace, která selhala

code

string

Kód odpovídající typu selhání operace

message

string

Zpráva o selhání operace

timestamp

string

Datum a čas, kdy došlo k chybě

shutdownOnIdleMode

Definuje, jestli se má virtuální počítač vypnout při nečinnosti, a kritéria pro detekci nečinnosti.

Name Typ Description
LowUsage

string

Virtuální počítač se bude považovat za nečinný, pokud uživatel chybí a spotřeba prostředků (procesoru a disku) bude nízká.

None

string

Virtuální počítač se nevypíná, když je nečinný.

UserAbsence

string

Virtuální počítač se bude považovat za nečinný, pokud není k dispozici vstup pomocí klávesnice nebo myši.

SupportInfo

Kontaktní informace a pokyny pro podporu

Name Typ Description
email

string

Kontaktní e-mailová adresa podpory.

instructions

string

Pokyny pro podporu.

phone

string

Kontaktní telefonní číslo podpory.

url

string

Webová adresa podpory.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identita, která vytvořila prostředek.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.