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
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
lab
|
path | True |
string |
Nom du lab. |
name
|
path | True |
string |
Nom de l’environnement. |
resource
|
path | True |
string |
Nom du groupe de ressources. |
subscription
|
path | True |
string |
L'ID de l'abonnement. |
user
|
path | True |
string |
Nom du profil utilisateur. |
api-version
|
query | True |
string |
Version d’API client. |
Corps de la demande
Nom | Type | Description |
---|---|---|
location |
string |
Emplacement de la ressource. |
properties.armTemplateDisplayName |
string |
Nom d’affichage du modèle 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
Nom | 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
Nom | Description |
---|---|
user_impersonation | Accéder à Microsoft Azure |
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
Nom | Description |
---|---|
Arm |
Propriétés d’un paramètre de modèle Azure Resource Manager. |
Cloud |
Erreur d’une requête REST. |
Cloud |
Corps d’une erreur d’une requête REST. |
Dtl |
Un environnement, qui est essentiellement un déploiement de modèle ARM. |
Environment |
Propriétés d’un déploiement d’environnement. |
ArmTemplateParameterProperties
Propriétés d’un paramètre de modèle Azure Resource Manager.
Nom | Type | Description |
---|---|---|
name |
string |
Nom du paramètre de modèle. |
value |
string |
Valeur du paramètre de modèle. |
CloudError
Erreur d’une requête REST.
Nom | Type | Description |
---|---|---|
error |
Erreur cloud qui s’est produite |
CloudErrorBody
Corps d’une erreur d’une requête REST.
Nom | Type | Description |
---|---|---|
code |
string |
Code d'erreur. |
details |
Erreurs internes. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
DtlEnvironment
Un environnement, qui est essentiellement un déploiement de modèle ARM.
Nom | Type | Description |
---|---|---|
id |
string |
Identificateur de la ressource. |
location |
string |
Emplacement de la ressource. |
name |
string |
Nom de la ressource. |
properties.armTemplateDisplayName |
string |
Nom d’affichage du modèle 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 |
Le provisionnement status de la ressource. |
properties.resourceGroupId |
string |
Identificateur du groupe de ressources contenant les ressources de l’environnement. |
properties.uniqueIdentifier |
string |
Identificateur immuable unique 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.
Nom | Type | Description |
---|---|---|
armTemplateId |
string |
Identificateur du modèle Azure Resource Manager. |
parameters |
Paramètres du modèle Azure Resource Manager. |