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 In Required Type 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 assinatura.

userName
path True
  • string

O nome do perfil do utilizador.

api-version
query True
  • string

Versão API do cliente.

Corpo do Pedido

Name Type Description
location
  • string

A localização do recurso.

properties.armTemplateDisplayName
  • string

O nome de exibição do modelo Azure Resource Manager que produziu o ambiente.

properties.deploymentProperties

As propriedades de implantação do ambiente.

tags
  • object

As etiquetas do recurso.

Respostas

Name Type Description
200 OK

OK

201 Created

Criado

Other Status Codes

BadRequest

Segurança

azure_auth

Bolsa Implícita OAuth2

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

Scopes

Name Description
user_impersonation Microsoft Azure de acesso

Exemplos

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

Definições

ArmTemplateParameterProperties

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

CloudError

Erro de um pedido DE REST.

CloudErrorBody

Corpo de um erro de um pedido de REPOUSO.

DtlEnvironment

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

EnvironmentDeploymentProperties

Propriedades de uma implantação ambiental.

ArmTemplateParameterProperties

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

Name Type Description
name
  • string

O nome do parâmetro do modelo.

value
  • string

O valor do parâmetro do modelo.

CloudError

Erro de um pedido DE REST.

Name Type Description
error

O erro na nuvem que ocorreu

CloudErrorBody

Corpo de um erro de um pedido de REPOUSO.

Name Type Description
code
  • string

O código de erro.

details

Erros internos.

message
  • string

A mensagem de erro.

target
  • string

O alvo do erro.

DtlEnvironment

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

Name Type 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 de exibição do modelo Azure Resource Manager que produziu o ambiente.

properties.createdByUser
  • string

O criador do ambiente.

properties.deploymentProperties

As propriedades de implantação do ambiente.

properties.provisioningState
  • string

O estado de provisionamento 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 único de um recurso (Guid).

tags
  • object

As etiquetas do recurso.

type
  • string

O tipo de recurso.

EnvironmentDeploymentProperties

Propriedades de uma implantação ambiental.

Name Type Description
armTemplateId
  • string

O identificador do modelo Azure Resource Manager.

parameters

Os parâmetros do modelo Azure Resource Manager.