Condividi tramite


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

Nome In Necessario Tipo Descrizione
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

Nome Tipo Descrizione
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

EnvironmentDeploymentProperties

Proprietà di distribuzione dell'ambiente.

tags

object

Tag della risorsa.

Risposte

Nome Tipo Descrizione
200 OK

DtlEnvironment

OK

201 Created

DtlEnvironment

Data di creazione

Other Status Codes

CloudError

BadRequest

Sicurezza

azure_auth

Concessione implicita OAuth2

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

Ambiti

Nome Descrizione
user_impersonation Accedere a Microsoft Azure

Esempio

Environments_CreateOrUpdate

Esempio di richiesta

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

Risposta di esempio

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

Nome Descrizione
ArmTemplateParameterProperties

Proprietà di un parametro 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 modello di Azure Resource Manager.

Nome Tipo Descrizione
name

string

Nome del parametro modello.

value

string

Valore del parametro modello.

CloudError

Errore da una richiesta REST.

Nome Tipo Descrizione
error

CloudErrorBody

Errore cloud che si è verificato

CloudErrorBody

Corpo di un errore da una richiesta REST.

Nome Tipo Descrizione
code

string

Codice di errore.

details

CloudErrorBody[]

Errori interni.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

DtlEnvironment

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

Nome Tipo Descrizione
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

Creatore dell'ambiente.

properties.deploymentProperties

EnvironmentDeploymentProperties

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.

Nome Tipo Descrizione
armTemplateId

string

Identificatore del modello di Azure Resource Manager.

parameters

ArmTemplateParameterProperties[]

Parametri del modello di Resource Manager di Azure.