Environments - Create Or Update

Creare o sostituire un ambiente esistente. Il completamento di questa operazione può richiedere tempo.

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

Parametri dell'URI

Name In Required Type Description
labName
path True
  • string

Il nome del lab.

name
path True
  • string

Il nome dell'ambiente.

resourceGroupName
path True
  • string

Nome del gruppo di risorse.

subscriptionId
path True
  • string

ID della sottoscrizione.

userName
path True
  • string

Nome del profilo utente.

api-version
query True
  • string

Versione API client.

Corpo della richiesta

Name Type Description
location
  • string

Il percorso della risorsa.

properties.armTemplateDisplayName
  • string

Nome visualizzato del modello di Resource Manager di Azure che ha prodotto l'ambiente.

properties.deploymentProperties

Proprietà di distribuzione dell'ambiente.

tags
  • object

Tag della risorsa.

Risposte

Name Type Description
200 OK

OK

201 Created

Data di creazione

Other Status Codes

BadRequest

Sicurezza

azure_auth

Concessione implicita OAuth2

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

Scopes

Name Description
user_impersonation Accesso Microsoft Azure

Esempio

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

Definizioni

ArmTemplateParameterProperties

Proprietà di un parametro di modello di Azure Resource Manager.

CloudError

Errore da una richiesta REST.

CloudErrorBody

Corpo di un errore da una richiesta REST.

DtlEnvironment

Un ambiente, che è essenzialmente una distribuzione di modelli di Resource Manager.

EnvironmentDeploymentProperties

Proprietà di una distribuzione dell'ambiente.

ArmTemplateParameterProperties

Proprietà di un parametro di modello di Azure Resource Manager.

Name Type Description
name
  • string

Nome del parametro del modello.

value
  • string

Valore del parametro del modello.

CloudError

Errore da una richiesta REST.

Name Type Description
error

Errore cloud che si è verificato

CloudErrorBody

Corpo di un errore da una richiesta REST.

Name Type Description
code
  • string

Codice di errore.

details

Errori interni.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore.

DtlEnvironment

Un ambiente, che è essenzialmente una distribuzione di modelli di Resource Manager.

Name Type Description
id
  • string

Identificatore della risorsa.

location
  • string

Il percorso della risorsa.

name
  • string

Nome della risorsa.

properties.armTemplateDisplayName
  • string

Nome visualizzato del modello di Resource Manager di Azure che ha prodotto l'ambiente.

properties.createdByUser
  • string

Autore dell'ambiente.

properties.deploymentProperties

Proprietà di distribuzione dell'ambiente.

properties.provisioningState
  • string

Stato del provisioning della risorsa.

properties.resourceGroupId
  • string

Identificatore del gruppo di risorse contenente le risorse dell'ambiente.

properties.uniqueIdentifier
  • string

Identificatore univoco non modificabile di una risorsa (GUID).

tags
  • object

Tag della risorsa.

type
  • string

Tipo di risorsa.

EnvironmentDeploymentProperties

Proprietà di una distribuzione dell'ambiente.

Name Type Description
armTemplateId
  • string

Identificatore del modello di Azure Resource Manager.

parameters

Parametri del modello di Resource Manager di Azure.