Labs - Create Or Update

Služba:: Dev Test Labs

Verze rozhraní API:: 2018-09-15

Vytvořte nebo nahraďte existující testovací prostředí. Dokončení této operace může chvíli trvat.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}?api-version=2018-09-15

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
name	path	True	string	Název testovacího prostředí.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
location	string	Umístění prostředku.
properties.announcement	LabAnnouncementProperties	Vlastnosti všech oznámení testovacích prostředí přidružených k tomuto testovacímu prostředí
properties.environmentPermission	EnvironmentPermission	Přístupová práva udělená uživateli při zřizování prostředí
properties.extendedProperties	object	Rozšířené vlastnosti testovacího prostředí používaného pro experimentální funkce
properties.labStorageType	StorageType	Typ úložiště používaného testovacím prostředím Může to být Premium nebo Standard. Výchozí hodnota je Premium.
properties.mandatoryArtifactsResourceIdsLinux	string[]	Seřazený seznam ID prostředků artefaktů, které by se měly použít u všech vytváření virtuálních počítačů s Linuxem ve výchozím nastavení před artefakty určenými uživatelem.
properties.mandatoryArtifactsResourceIdsWindows	string[]	Seřazený seznam ID prostředků artefaktů, které by se měly použít u všech vytváření virtuálních počítačů s Windows ve výchozím nastavení před artefakty určenými uživatelem.
properties.premiumDataDisks	PremiumDataDisk	Nastavení pro povolení využití datových disků Úrovně Premium. Pokud je jeho hodnota Povolená, je povoleno vytváření datových disků Úrovně Standard nebo Premium. Pokud je jeho hodnota Zakázáno, je povoleno pouze vytváření standardních datových disků.
properties.support	LabSupportProperties	Vlastnosti jakékoli zprávy podpory testovacího prostředí přidružené k tomuto testovacímu prostředí
tags	object	Značky prostředku.

Odpovědi

Name	Typ	Description
200 OK	Lab	Operace aktualizace prostředku "Lab" byla úspěšná
201 Created	Lab	Operace vytvoření prostředku "Lab" byla úspěšná Hlavičky Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

Lab

Operace aktualizace prostředku "Lab" byla úspěšná

201 Created

Lab

Operace vytvoření prostředku "Lab" byla úspěšná

Hlavičky

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Labs_CreateOrUpdate

Ukázkový požadavek

HTTP

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}?api-version=2018-09-15

{
  "location": "{location}",
  "properties": {
    "labStorageType": "{Standard|Premium}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "name": "{labName}",
  "type": "Microsoft.DevTestLab/labs",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
  "location": "{location}",
  "properties": {
    "announcement": {
      "enabled": "Disabled",
      "expired": false,
      "markdown": "",
      "title": ""
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "environmentPermission": "Reader",
    "labStorageType": "Standard",
    "mandatoryArtifactsResourceIdsLinux": [],
    "mandatoryArtifactsResourceIdsWindows": [],
    "premiumDataDisks": "Disabled",
    "provisioningState": "Creating",
    "support": {
      "enabled": "Disabled",
      "markdown": ""
    },
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Stavový kód:: 201

{
  "name": "{labName}",
  "type": "Microsoft.DevTestLab/labs",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
  "location": "{location}",
  "properties": {
    "announcement": {
      "enabled": "Disabled",
      "expired": false,
      "markdown": "",
      "title": ""
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "environmentPermission": "Reader",
    "labStorageType": "Standard",
    "mandatoryArtifactsResourceIdsLinux": [],
    "mandatoryArtifactsResourceIdsWindows": [],
    "premiumDataDisks": "Disabled",
    "provisioningState": "Creating",
    "support": {
      "enabled": "Disabled",
      "markdown": ""
    },
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Definice

Name	Description
EnableStatus	Označuje, jestli je zdroj artefaktů povolený (hodnoty: Povoleno, Zakázáno).
EnvironmentPermission	Přístupová práva udělená uživateli při zřizování prostředí
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
Lab	Cvičení.
LabAnnouncementProperties	Vlastnosti banneru oznámení testovacího prostředí
LabSupportProperties	Vlastnosti banneru podpory testovacího prostředí
PremiumDataDisk	Nastavení pro povolení využití datových disků Úrovně Premium. Pokud je jeho hodnota Povolená, je povoleno vytváření datových disků Úrovně Standard nebo Premium. Pokud je jeho hodnota Zakázáno, je povoleno pouze vytváření standardních datových disků.
StorageType	Typ úložiště disku (tj. Standard, Premium).

EnableStatus

Výčet

Označuje, jestli je zdroj artefaktů povolený (hodnoty: Povoleno, Zakázáno).

Hodnota	Description
Enabled
Disabled

EnvironmentPermission

Výčet

Přístupová práva udělená uživateli při zřizování prostředí

Hodnota	Description
Reader
Contributor

ErrorAdditionalInfo

Objekt

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

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

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

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Lab

Objekt

Cvičení.

Name	Typ	Default value	Description
id	string		Identifikátor prostředku.
location	string		Umístění prostředku.
name	string		Název prostředku.
properties.announcement	LabAnnouncementProperties		Vlastnosti všech oznámení testovacích prostředí přidružených k tomuto testovacímu prostředí
properties.artifactsStorageAccount	string		Účet úložiště artefaktů testovacího prostředí.
properties.createdDate	string (date-time)		Datum vytvoření testovacího prostředí.
properties.defaultPremiumStorageAccount	string		Výchozí účet premium storage testovacího prostředí.
properties.defaultStorageAccount	string		Výchozí účet úložiště testovacího prostředí.
properties.environmentPermission	EnvironmentPermission		Přístupová práva udělená uživateli při zřizování prostředí
properties.extendedProperties	object		Rozšířené vlastnosti testovacího prostředí používaného pro experimentální funkce
properties.labStorageType	StorageType	Premium	Typ úložiště používaného testovacím prostředím Může to být Premium nebo Standard. Výchozí hodnota je Premium.
properties.loadBalancerId	string		Nástroj pro vyrovnávání zatížení používaný pro testovací virtuální počítače, které používají sdílenou IP adresu.
properties.mandatoryArtifactsResourceIdsLinux	string[]		Seřazený seznam ID prostředků artefaktů, které by se měly použít u všech vytváření virtuálních počítačů s Linuxem ve výchozím nastavení před artefakty určenými uživatelem.
properties.mandatoryArtifactsResourceIdsWindows	string[]		Seřazený seznam ID prostředků artefaktů, které by se měly použít u všech vytváření virtuálních počítačů s Windows ve výchozím nastavení před artefakty určenými uživatelem.
properties.networkSecurityGroupId	string		Skupina zabezpečení sítě připojená k síťovým rozhraním testovacích virtuálních počítačů pro omezení otevřených portů
properties.premiumDataDiskStorageAccount	string		Účet úložiště datových disků úrovně Premium v testovacím prostředí.
properties.premiumDataDisks	PremiumDataDisk		Nastavení pro povolení využití datových disků Úrovně Premium. Pokud je jeho hodnota Povolená, je povoleno vytváření datových disků Úrovně Standard nebo Premium. Pokud je jeho hodnota Zakázáno, je povoleno pouze vytváření standardních datových disků.
properties.provisioningState	string		Stav zřizování prostředku.
properties.publicIpId	string		Veřejná IP adresa nástroje pro vyrovnávání zatížení testovacího prostředí.
properties.support	LabSupportProperties		Vlastnosti jakékoli zprávy podpory testovacího prostředí přidružené k tomuto testovacímu prostředí
properties.uniqueIdentifier	string		Jedinečný neměnný identifikátor prostředku (GUID).
properties.vaultName	string		Trezor klíčů testovacího prostředí.
properties.vmCreationResourceGroup	string		Skupina prostředků, ve které se vytvoří všechny nové virtuální počítače testovacího prostředí. Pokud chcete službě DevTest Labs umožnit spravovat vytváření skupin prostředků, nastavte tuto hodnotu na hodnotu null.
tags	object		Značky prostředku.
type	string		Typ prostředku.

LabAnnouncementProperties

Objekt

Vlastnosti banneru oznámení testovacího prostředí

Name	Typ	Description
enabled	EnableStatus	Je oznámení testovacího prostředí v tuto chvíli aktivní nebo povolené?
expirationDate	string (date-time)	Čas, kdy vyprší platnost oznámení (null pro nikdy)
expired	boolean	Vypršela platnost tohoto oznámení?
markdown	string	Text markdownu (pokud existuje) zobrazený v uživatelském rozhraní tohoto testovacího prostředí. Pokud necháte prázdnou hodnotu nebo hodnotu null, nezobrazí se nic.
provisioningState	string	Stav zřizování prostředku.
title	string	Název prostého textu pro oznámení testovacího prostředí
uniqueIdentifier	string	Jedinečný neměnný identifikátor prostředku (GUID).

LabSupportProperties

Objekt

Vlastnosti banneru podpory testovacího prostředí

Name	Typ	Description
enabled	EnableStatus	Je v tuto chvíli informační zpráva podpory testovacího prostředí aktivní nebo povolená?
markdown	string	Text markdownu (pokud existuje) zobrazený v uživatelském rozhraní tohoto testovacího prostředí. Pokud necháte prázdnou hodnotu nebo hodnotu null, nezobrazí se nic.

PremiumDataDisk

Výčet

Nastavení pro povolení využití datových disků Úrovně Premium. Pokud je jeho hodnota Povolená, je povoleno vytváření datových disků Úrovně Standard nebo Premium. Pokud je jeho hodnota Zakázáno, je povoleno pouze vytváření standardních datových disků.

Hodnota	Description
Disabled
Enabled

StorageType

Výčet

Typ úložiště disku (tj. Standard, Premium).

Hodnota	Description
Standard
Premium
StandardSSD

Sdílet prostřednictvím

Labs - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Labs_CreateOrUpdate

Ukázkový požadavek

Ukázková odpověď

Definice

EnableStatus

EnvironmentPermission

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Lab

LabAnnouncementProperties

LabSupportProperties

PremiumDataDisk

StorageType