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 |
---|---|---|---|---|
lab
|
path | True |
string |
O nome do laboratório. |
name
|
path | True |
string |
O nome do ambiente. |
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
path | True |
string |
O ID da subscrição. |
user
|
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 |
As propriedades de implementação do ambiente. |
|
tags |
object |
As etiquetas do recurso. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Criado |
|
Other Status Codes |
BadRequest |
Segurança
azure_auth
Concessão Implícita OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Aceder ao Microsoft Azure |
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
Name | Description |
---|---|
Arm |
Propriedades de um parâmetro de modelo do Azure Resource Manager. |
Cloud |
Erro de um pedido REST. |
Cloud |
Corpo de um erro de um pedido REST. |
Dtl |
Um ambiente, que é essencialmente uma implementação de modelo do ARM. |
Environment |
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 |
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 |
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 |
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 |
Os parâmetros do modelo de Resource Manager do Azure. |