Compartir a través de


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

Nombre En Requerido Tipo 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

Nombre Tipo 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

EnvironmentDeploymentProperties

Propiedades de implementación del entorno.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

DtlEnvironment

Aceptar

201 Created

DtlEnvironment

Creado

Other Status Codes

CloudError

BadRequest

Seguridad

azure_auth

Concesión implícita de OAuth2

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation Acceso a Microsoft Azure

Ejemplos

Environments_CreateOrUpdate

Solicitud de ejemplo

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

Respuesta de muestra

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

Nombre Description
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.

Nombre Tipo Description
name

string

Nombre del parámetro de plantilla.

value

string

Valor del parámetro de plantilla.

CloudError

Error de una solicitud REST.

Nombre Tipo Description
error

CloudErrorBody

Error en la nube que se produjo

CloudErrorBody

Cuerpo de un error de una solicitud REST.

Nombre Tipo Description
code

string

Código de error.

details

CloudErrorBody[]

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.

Nombre Tipo 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

EnvironmentDeploymentProperties

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

Etiquetas del recurso.

type

string

Tipo de recurso.

EnvironmentDeploymentProperties

Propiedades de una implementación de entorno.

Nombre Tipo Description
armTemplateId

string

Identificador de la plantilla de Azure Resource Manager.

parameters

ArmTemplateParameterProperties[]

Parámetros de la plantilla de Azure Resource Manager.