Labs - Create Or Update

Service:: Dev Test Labs

Version d'API:: 2018-09-15

Créez ou remplacez un laboratoire existant. Cette opération peut prendre un certain temps.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
name	path	True	string	Nom du labo.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
location	string	Emplacement de la ressource.
properties.announcement	LabAnnouncementProperties	Propriétés d’une annonce de laboratoire associée à ce labo
properties.environmentPermission	EnvironmentPermission	Droits d’accès à accorder à l’utilisateur lors de l’approvisionnement d’un environnement
properties.extendedProperties	object	Propriétés étendues du labo utilisées pour les fonctionnalités expérimentales
properties.labStorageType	StorageType	Type de stockage utilisé par le labo. Il peut être Premium ou Standard. La valeur par défaut est Premium.
properties.mandatoryArtifactsResourceIdsLinux	string[]	Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués sur toutes les créations de machines virtuelles Linux par défaut, avant les artefacts spécifiés par l’utilisateur.
properties.mandatoryArtifactsResourceIdsWindows	string[]	Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués à toutes les créations de machines virtuelles Windows par défaut, avant les artefacts spécifiés par l’utilisateur.
properties.premiumDataDisks	PremiumDataDisk	Paramètre permettant d’activer l’utilisation des disques de données Premium. Lorsque sa valeur est « Enabled », la création de disques de données standard ou Premium est autorisée. Lorsque sa valeur est « Disabled », seule la création de disques de données standard est autorisée.
properties.support	LabSupportProperties	Propriétés d’un message de support lab associé à ce labo
tags	object	Balises de la ressource.

Réponses

Nom	Type	Description
200 OK	Lab	Réussite de l’opération de mise à jour de la ressource « Lab »
201 Created	Lab	Ressource : l’opération de création « Lab » a réussi En-têtes Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

Lab

Réussite de l’opération de mise à jour de la ressource « Lab »

201 Created

Lab

Ressource : l’opération de création « Lab » a réussi

En-têtes

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Labs_CreateOrUpdate

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
  }
}

Code d’état:: 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"
  }
}

Définitions

Nom	Description
EnableStatus	Indique si la source de l’artefact est activée (valeurs : Activé, Désactivé).
EnvironmentPermission	Droits d’accès à accorder à l’utilisateur lors de l’approvisionnement d’un environnement
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
Lab	Un laboratoire.
LabAnnouncementProperties	Propriétés de la bannière d’annonce d’un laboratoire
LabSupportProperties	Propriétés de la bannière de support d’un laboratoire
PremiumDataDisk	Paramètre permettant d’activer l’utilisation des disques de données Premium. Lorsque sa valeur est « Enabled », la création de disques de données standard ou Premium est autorisée. Lorsque sa valeur est « Disabled », seule la création de disques de données standard est autorisée.
StorageType	Type de stockage pour le disque (par exemple, Standard, Premium).

EnableStatus

Énumération

Indique si la source de l’artefact est activée (valeurs : Activé, Désactivé).

Valeur	Description
Enabled
Disabled

EnvironmentPermission

Énumération

Droits d’accès à accorder à l’utilisateur lors de l’approvisionnement d’un environnement

Valeur	Description
Reader
Contributor

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

Lab

Object

Un laboratoire.

Nom	Type	Valeur par défaut	Description
id	string		Identificateur de la ressource.
location	string		Emplacement de la ressource.
name	string		Nom de la ressource.
properties.announcement	LabAnnouncementProperties		Propriétés d’une annonce de laboratoire associée à ce labo
properties.artifactsStorageAccount	string		Compte de stockage d’artefact du labo.
properties.createdDate	string (date-time)		Date de création du labo.
properties.defaultPremiumStorageAccount	string		Compte de stockage Premium par défaut du labo.
properties.defaultStorageAccount	string		Compte de stockage par défaut du labo.
properties.environmentPermission	EnvironmentPermission		Droits d’accès à accorder à l’utilisateur lors de l’approvisionnement d’un environnement
properties.extendedProperties	object		Propriétés étendues du labo utilisées pour les fonctionnalités expérimentales
properties.labStorageType	StorageType	Premium	Type de stockage utilisé par le labo. Il peut être Premium ou Standard. La valeur par défaut est Premium.
properties.loadBalancerId	string		Équilibreur de charge utilisé pour les machines virtuelles lab qui utilisent une adresse IP partagée.
properties.mandatoryArtifactsResourceIdsLinux	string[]		Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués sur toutes les créations de machines virtuelles Linux par défaut, avant les artefacts spécifiés par l’utilisateur.
properties.mandatoryArtifactsResourceIdsWindows	string[]		Liste ordonnée des ID de ressource d’artefacts qui doivent être appliqués à toutes les créations de machines virtuelles Windows par défaut, avant les artefacts spécifiés par l’utilisateur.
properties.networkSecurityGroupId	string		Groupe de sécurité réseau attaché aux interfaces réseau des machines virtuelles lab pour restreindre les ports ouverts.
properties.premiumDataDiskStorageAccount	string		Compte de stockage de disque de données Premium du labo.
properties.premiumDataDisks	PremiumDataDisk		Paramètre permettant d’activer l’utilisation des disques de données Premium. Lorsque sa valeur est « Enabled », la création de disques de données standard ou Premium est autorisée. Lorsque sa valeur est « Disabled », seule la création de disques de données standard est autorisée.
properties.provisioningState	string		État d’approvisionnement de la ressource.
properties.publicIpId	string		Adresse IP publique de l’équilibreur de charge du labo.
properties.support	LabSupportProperties		Propriétés d’un message de support lab associé à ce labo
properties.uniqueIdentifier	string		Identificateur immuable unique d’une ressource (GUID).
properties.vaultName	string		Coffre de clés du labo.
properties.vmCreationResourceGroup	string		Groupe de ressources dans lequel toutes les nouvelles machines virtuelles lab seront créées. Pour permettre à DevTest Labs de gérer la création d’un groupe de ressources, définissez cette valeur sur Null.
tags	object		Balises de la ressource.
type	string		Type de la ressource.

LabAnnouncementProperties

Object

Propriétés de la bannière d’annonce d’un laboratoire

Nom	Type	Description
enabled	EnableStatus	L’annonce du labo est-elle active/activée pour l’instant ?
expirationDate	string (date-time)	Heure à laquelle l’annonce expire (null pour jamais)
expired	boolean	Cette annonce a-t-elle expiré ?
markdown	string	Texte markdown (le cas échéant) affiché par ce laboratoire dans l’interface utilisateur. Si la valeur est vide/null, rien ne s’affiche.
provisioningState	string	État d’approvisionnement de la ressource.
title	string	Titre en texte brut de l’annonce du labo
uniqueIdentifier	string	Identificateur immuable unique d’une ressource (GUID).

LabSupportProperties

Object

Propriétés de la bannière de support d’un laboratoire

Nom	Type	Description
enabled	EnableStatus	La bannière de prise en charge du labo est-elle active/activée pour l’instant ?
markdown	string	Texte markdown (le cas échéant) affiché par ce laboratoire dans l’interface utilisateur. Si la valeur est vide/null, rien ne s’affiche.

PremiumDataDisk

Énumération

Paramètre permettant d’activer l’utilisation des disques de données Premium. Lorsque sa valeur est « Enabled », la création de disques de données standard ou Premium est autorisée. Lorsque sa valeur est « Disabled », seule la création de disques de données standard est autorisée.

Valeur	Description
Disabled
Enabled

StorageType

Énumération

Type de stockage pour le disque (par exemple, Standard, Premium).

Valeur	Description
Standard
Premium
StandardSSD

Partager via

Labs - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Labs_CreateOrUpdate

Exemple de requête

Exemple de réponse

Définitions

EnableStatus

EnvironmentPermission

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Lab

LabAnnouncementProperties

LabSupportProperties

PremiumDataDisk

StorageType