Partilhar via


Environments - Create Or Update

Criar ou substituir um ambiente existente. Esta operação pode demorar algum tempo.

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

Parâmetros do URI

Name Em Necessário Tipo Description
labName
path True

string

O nome do laboratório.

name
path True

string

O nome do ambiente.

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

O ID da subscrição.

userName
path True

string

O nome do perfil de utilizador.

api-version
query True

string

Versão da API de Cliente.

Corpo do Pedido

Name Tipo Description
location

string

A localização do recurso.

properties.armTemplateDisplayName

string

O nome a apresentar do modelo Resource Manager do Azure que produziu o ambiente.

properties.deploymentProperties

EnvironmentDeploymentProperties

As propriedades de implementação do ambiente.

tags

object

As etiquetas do recurso.

Respostas

Name Tipo Description
200 OK

DtlEnvironment

OK

201 Created

DtlEnvironment

Criado

Other Status Codes

CloudError

BadRequest

Segurança

azure_auth

Concessão Implícita OAuth2

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation Aceder ao Microsoft Azure

Exemplos

Environments_CreateOrUpdate

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
ArmTemplateParameterProperties

Propriedades de um parâmetro de modelo do Azure Resource Manager.

CloudError

Erro de um pedido REST.

CloudErrorBody

Corpo de um erro de um pedido REST.

DtlEnvironment

Um ambiente, que é essencialmente uma implementação de modelo do ARM.

EnvironmentDeploymentProperties

Propriedades de uma implementação de ambiente.

ArmTemplateParameterProperties

Propriedades de um parâmetro de modelo do Azure Resource Manager.

Name Tipo Description
name

string

O nome do parâmetro de modelo.

value

string

O valor do parâmetro de modelo.

CloudError

Erro de um pedido REST.

Name Tipo Description
error

CloudErrorBody

O erro na cloud que ocorreu

CloudErrorBody

Corpo de um erro de um pedido REST.

Name Tipo Description
code

string

O código de erro.

details

CloudErrorBody[]

Erros internos.

message

string

A mensagem de erro.

target

string

O destino do erro.

DtlEnvironment

Um ambiente, que é essencialmente uma implementação de modelo do ARM.

Name Tipo Description
id

string

O identificador do recurso.

location

string

A localização do recurso.

name

string

O nome do recurso.

properties.armTemplateDisplayName

string

O nome a apresentar do modelo Resource Manager do Azure que produziu o ambiente.

properties.createdByUser

string

O criador do ambiente.

properties.deploymentProperties

EnvironmentDeploymentProperties

As propriedades de implementação do ambiente.

properties.provisioningState

string

O estado de aprovisionamento do recurso.

properties.resourceGroupId

string

O identificador do grupo de recursos que contém os recursos do ambiente.

properties.uniqueIdentifier

string

O identificador imutável exclusivo de um recurso (Guid).

tags

object

As etiquetas do recurso.

type

string

O tipo do recurso.

EnvironmentDeploymentProperties

Propriedades de uma implementação de ambiente.

Name Tipo Description
armTemplateId

string

O identificador do modelo do Azure Resource Manager.

parameters

ArmTemplateParameterProperties[]

Os parâmetros do modelo de Resource Manager do Azure.