Environments - Create Or Update

Cree o reemplace un entorno existente. Esta operación puede tardar varios minutos en completarse.

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 de identificador URI

Name In Required Type Description
labName
path True
  • string

El nombre del laboratorio.

name
path True
  • string

El nombre del entorno.

resourceGroupName
path True
  • string

Nombre del grupo de recursos.

subscriptionId
path True
  • string

Identificador de la suscripción.

userName
path True
  • string

Nombre del perfil de usuario.

api-version
query True
  • string

Versión de API del cliente.

Cuerpo de la solicitud

Name Type Description
location
  • string

Ubicación del recurso.

properties.armTemplateDisplayName
  • string

Nombre para mostrar de la plantilla de Azure Resource Manager que generó el entorno.

properties.deploymentProperties

Las propiedades de implementación del entorno.

tags
  • object

Las etiquetas del recurso.

Respuestas

Name Type Description
200 OK

Aceptar

201 Created

Creado

Other Status Codes

BadRequest

Seguridad

azure_auth

Concesión implícita de OAuth2

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

Scopes

Name Description
user_impersonation Acceso a Microsoft Azure

Ejemplos

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

Definiciones

ArmTemplateParameterProperties

Propiedades de un parámetro de plantilla de Azure Resource Manager.

CloudError

Error de una solicitud REST.

CloudErrorBody

Cuerpo de un error de una solicitud REST.

DtlEnvironment

Un entorno, que es básicamente una implementación de plantilla de ARM.

EnvironmentDeploymentProperties

Propiedades de una implementación de entorno.

ArmTemplateParameterProperties

Propiedades de un parámetro de plantilla de Azure Resource Manager.

Name Type Description
name
  • string

Nombre del parámetro de plantilla.

value
  • string

Valor del parámetro de plantilla.

CloudError

Error de una solicitud REST.

Name Type Description
error

Error en la nube que se produjo

CloudErrorBody

Cuerpo de un error de una solicitud REST.

Name Type Description
code
  • string

Código de error.

details

Errores internos.

message
  • string

El mensaje de error.

target
  • string

Destino del error.

DtlEnvironment

Un entorno, que es básicamente una implementación de plantilla de ARM.

Name Type Description
id
  • string

Identificador del recurso.

location
  • string

Ubicación del recurso.

name
  • string

Nombre del recurso.

properties.armTemplateDisplayName
  • string

Nombre para mostrar de la plantilla de Azure Resource Manager que generó el entorno.

properties.createdByUser
  • string

Creador del entorno.

properties.deploymentProperties

Las propiedades de implementación del entorno.

properties.provisioningState
  • string

Estado de aprovisionamiento del recurso.

properties.resourceGroupId
  • string

Identificador del grupo de recursos que contiene los recursos del entorno.

properties.uniqueIdentifier
  • string

Identificador inmutable único de un recurso (Guid).

tags
  • object

Las etiquetas del recurso.

type
  • string

Tipo de recurso.

EnvironmentDeploymentProperties

Propiedades de una implementación de entorno.

Name Type Description
armTemplateId
  • string

Identificador de la plantilla de Azure Resource Manager.

parameters

Parámetros de la plantilla de Azure Resource Manager.