Labs - Create Or Update

Servizio:: Dev Test Labs

Versione API:: 2018-09-15

Creare o sostituire un lab esistente. Il completamento di questa operazione può richiedere alcuni minuti.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
name	path	True	string	Nome del lab.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
location	string	Posizione della risorsa.
properties.announcement	LabAnnouncementProperties	Proprietà di qualsiasi annuncio lab associato a questo lab
properties.environmentPermission	EnvironmentPermission	Diritti di accesso da concedere all'utente durante il provisioning di un ambiente
properties.extendedProperties	object	Proprietà estese del lab usato per le funzionalità sperimentali
properties.labStorageType	StorageType	Tipo di spazio di archiviazione usato dal lab. Può essere Premium o Standard. Il valore predefinito è Premium.
properties.mandatoryArtifactsResourceIdsLinux	string[]	Elenco ordinato di ID risorsa artefatti che devono essere applicati a tutte le creazioni di macchine virtuali Linux per impostazione predefinita, prima degli artefatti specificati dall'utente.
properties.mandatoryArtifactsResourceIdsWindows	string[]	Elenco ordinato di ID risorsa artefatto che devono essere applicati a tutte le creazioni di macchine virtuali Windows per impostazione predefinita, prima degli artefatti specificati dall'utente.
properties.premiumDataDisks	PremiumDataDisk	Impostazione per abilitare l'utilizzo dei dischi dati Premium. Quando il valore è "Abilitato", è consentita la creazione di dischi dati Standard o Premium. Quando il valore è "Disabled", è consentita solo la creazione di dischi dati standard.
properties.support	LabSupportProperties	Proprietà di qualsiasi messaggio di supporto lab associato a questo lab
tags	object	Tag della risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	Lab	Operazione di aggiornamento della risorsa 'Lab' riuscita
201 Created	Lab	Operazione di creazione della risorsa 'Lab' riuscita Intestazioni Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

Lab

Operazione di aggiornamento della risorsa 'Lab' riuscita

201 Created

Lab

Operazione di creazione della risorsa 'Lab' riuscita

Intestazioni

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Labs_CreateOrUpdate

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
  }
}

Codice di stato:: 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"
  }
}

Definizioni

Nome	Descrizione
EnableStatus	Indica se l'origine dell'artefatto è abilitata (valori: Abilitato, Disabilitato).
EnvironmentPermission	Diritti di accesso da concedere all'utente durante il provisioning di un ambiente
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
Lab	Un lab.
LabAnnouncementProperties	Proprietà del banner dell'annuncio di un lab
LabSupportProperties	Proprietà del banner di supporto di un lab
PremiumDataDisk	Impostazione per abilitare l'utilizzo dei dischi dati Premium. Quando il valore è "Abilitato", è consentita la creazione di dischi dati Standard o Premium. Quando il valore è "Disabled", è consentita solo la creazione di dischi dati standard.
StorageType	Tipo di archiviazione per il disco (ad esempio Standard, Premium).

EnableStatus

Enumerazione

Indica se l'origine dell'artefatto è abilitata (valori: Abilitato, Disabilitato).

Valore	Descrizione
Enabled
Disabled

EnvironmentPermission

Enumerazione

Diritti di accesso da concedere all'utente durante il provisioning di un ambiente

Valore	Descrizione
Reader
Contributor

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

Lab

Object

Un lab.

Nome	Tipo	Valore predefinito	Descrizione
id	string		Identificatore della risorsa.
location	string		Posizione della risorsa.
name	string		Nome della risorsa.
properties.announcement	LabAnnouncementProperties		Proprietà di qualsiasi annuncio lab associato a questo lab
properties.artifactsStorageAccount	string		Account di archiviazione dell'artefatto del lab.
properties.createdDate	string (date-time)		Data di creazione del lab.
properties.defaultPremiumStorageAccount	string		Account di archiviazione Premium predefinito del lab.
properties.defaultStorageAccount	string		Account di archiviazione predefinito del lab.
properties.environmentPermission	EnvironmentPermission		Diritti di accesso da concedere all'utente durante il provisioning di un ambiente
properties.extendedProperties	object		Proprietà estese del lab usato per le funzionalità sperimentali
properties.labStorageType	StorageType	Premium	Tipo di spazio di archiviazione usato dal lab. Può essere Premium o Standard. Il valore predefinito è Premium.
properties.loadBalancerId	string		Servizio di bilanciamento del carico usato per le macchine virtuali del lab che usano l'indirizzo IP condiviso.
properties.mandatoryArtifactsResourceIdsLinux	string[]		Elenco ordinato di ID risorsa artefatti che devono essere applicati a tutte le creazioni di macchine virtuali Linux per impostazione predefinita, prima degli artefatti specificati dall'utente.
properties.mandatoryArtifactsResourceIdsWindows	string[]		Elenco ordinato di ID risorsa artefatto che devono essere applicati a tutte le creazioni di macchine virtuali Windows per impostazione predefinita, prima degli artefatti specificati dall'utente.
properties.networkSecurityGroupId	string		Gruppo di sicurezza di rete collegato alle interfacce di rete delle macchine virtuali del lab per limitare le porte aperte.
properties.premiumDataDiskStorageAccount	string		Account di archiviazione del disco dati Premium del lab.
properties.premiumDataDisks	PremiumDataDisk		Impostazione per abilitare l'utilizzo dei dischi dati Premium. Quando il valore è "Abilitato", è consentita la creazione di dischi dati Standard o Premium. Quando il valore è "Disabled", è consentita solo la creazione di dischi dati standard.
properties.provisioningState	string		Stato del provisioning della risorsa.
properties.publicIpId	string		Indirizzo IP pubblico per il servizio di bilanciamento del carico del lab.
properties.support	LabSupportProperties		Proprietà di qualsiasi messaggio di supporto lab associato a questo lab
properties.uniqueIdentifier	string		Identificatore univoco non modificabile di una risorsa (GUID).
properties.vaultName	string		Insieme di credenziali delle chiavi del lab.
properties.vmCreationResourceGroup	string		Gruppo di risorse in cui verranno create tutte le nuove macchine virtuali lab. Per consentire a DevTest Labs di gestire la creazione del gruppo di risorse, impostare questo valore su Null.
tags	object		Tag della risorsa.
type	string		Tipo della risorsa.

LabAnnouncementProperties

Object

Proprietà del banner dell'annuncio di un lab

Nome	Tipo	Descrizione
enabled	EnableStatus	L'annuncio del lab è attivo/abilitato al momento?
expirationDate	string (date-time)	Ora in cui l'annuncio scade (null per mai)
expired	boolean	L'annuncio è scaduto?
markdown	string	Testo markdown (se presente) visualizzato in questo lab nell'interfaccia utente. Se lasciato vuoto/null, non verrà visualizzato alcun elemento.
provisioningState	string	Stato del provisioning della risorsa.
title	string	Titolo di testo normale per l'annuncio del lab
uniqueIdentifier	string	Identificatore univoco non modificabile di una risorsa (GUID).

LabSupportProperties

Object

Proprietà del banner di supporto di un lab

Nome	Tipo	Descrizione
enabled	EnableStatus	Al momento il banner di supporto del lab è attivo/abilitato?
markdown	string	Testo markdown (se presente) visualizzato in questo lab nell'interfaccia utente. Se lasciato vuoto/null, non verrà visualizzato alcun elemento.

PremiumDataDisk

Enumerazione

Impostazione per abilitare l'utilizzo dei dischi dati Premium. Quando il valore è "Abilitato", è consentita la creazione di dischi dati Standard o Premium. Quando il valore è "Disabled", è consentita solo la creazione di dischi dati standard.

Valore	Descrizione
Disabled
Enabled

StorageType

Enumerazione

Tipo di archiviazione per il disco (ad esempio Standard, Premium).

Valore	Descrizione
Standard
Premium
StandardSSD

Condividi tramite

Labs - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Labs_CreateOrUpdate

Esempio di richiesta

Risposta di esempio

Definizioni

EnableStatus

EnvironmentPermission

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Lab

LabAnnouncementProperties

LabSupportProperties

PremiumDataDisk

StorageType