Environments - Create Or Update

Créez ou remplacez un environnement existant. Cet opérateur peut prendre un certain temps.

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

Paramètres URI

Name In Required Type Description
labName
path True
  • string

Nom du lab.

name
path True
  • string

Nom de l’environnement.

resourceGroupName
path True
  • string

Nom du groupe de ressources.

subscriptionId
path True
  • string

L'ID de l'abonnement.

userName
path True
  • string

Nom du profil utilisateur.

api-version
query True
  • string

Version d’API client.

Corps de la demande

Name Type Description
location
  • string

Emplacement de la ressource.

properties.armTemplateDisplayName
  • string

Nom complet du modèle de Azure Resource Manager qui a produit l’environnement.

properties.deploymentProperties

Propriétés de déploiement de l’environnement.

tags
  • object

Balises de la ressource.

Réponses

Name Type Description
200 OK

Ok

201 Created

Date de création

Other Status Codes

BadRequest

Sécurité

azure_auth

Octroi implicite OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Microsoft Azure d’accès

Exemples

Environments_CreateOrUpdate

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/users/@me/environments/{environmentName}?api-version=2018-09-15
{
  "properties": {
    "deploymentProperties": {
      "parameters": [],
      "armTemplateId": "/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/users/{uniqueIdentifier}/environments/{environmentName}",
  "name": "{environmentName}",
  "type": "Microsoft.DevTestLab/labs/users/environments",
  "location": "{location}",
  "properties": {
    "deploymentProperties": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    },
    "createdByUser": "user@contoso.com",
    "provisioningState": "Succeeded",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/users/{uniqueIdentifier}/environments/{environmentName}",
  "name": "{environmentName}",
  "type": "Microsoft.DevTestLab/labs/users/environments",
  "location": "{location}",
  "properties": {
    "deploymentProperties": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    },
    "createdByUser": "user@contoso.com",
    "provisioningState": "Creating",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Définitions

ArmTemplateParameterProperties

Propriétés d’un paramètre de modèle Azure Resource Manager.

CloudError

Erreur d’une demande REST.

CloudErrorBody

Corps d’une erreur à partir d’une demande REST.

DtlEnvironment

Environnement, qui est essentiellement un déploiement de modèle ARM.

EnvironmentDeploymentProperties

Propriétés d’un déploiement d’environnement.

ArmTemplateParameterProperties

Propriétés d’un paramètre de modèle Azure Resource Manager.

Name Type Description
name
  • string

Nom du paramètre de modèle.

value
  • string

Valeur du paramètre de modèle.

CloudError

Erreur d’une demande REST.

Name Type Description
error

Erreur de Cloud qui s’est produite

CloudErrorBody

Corps d’une erreur à partir d’une demande REST.

Name Type Description
code
  • string

Code d'erreur.

details

Erreurs internes.

message
  • string

Message d’erreur.

target
  • string

Cible de l’erreur.

DtlEnvironment

Environnement, qui est essentiellement un déploiement de modèle ARM.

Name Type Description
id
  • string

Identificateur de la ressource.

location
  • string

Emplacement de la ressource.

name
  • string

Nom de la ressource.

properties.armTemplateDisplayName
  • string

Nom complet du modèle de Azure Resource Manager qui a produit l’environnement.

properties.createdByUser
  • string

Créateur de l’environnement.

properties.deploymentProperties

Propriétés de déploiement de l’environnement.

properties.provisioningState
  • string

État d’approvisionnement de la ressource.

properties.resourceGroupId
  • string

Identificateur du groupe de ressources contenant les ressources de l’environnement.

properties.uniqueIdentifier
  • string

Identificateur unique immuable d’une ressource (Guid).

tags
  • object

Balises de la ressource.

type
  • string

Type de la ressource.

EnvironmentDeploymentProperties

Propriétés d’un déploiement d’environnement.

Name Type Description
armTemplateId
  • string

Identificateur du modèle de Azure Resource Manager.

parameters

Paramètres du modèle de Azure Resource Manager.