Compartir a través de


Environment Settings - Update

Modifique las propiedades de la configuración del entorno.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}?api-version=2018-10-15

Parámetros de identificador URI

Nombre En Requerido Tipo Description
environmentSettingName
path True

string

Nombre del entorno Setting.

labAccountName
path True

string

Nombre de la cuenta de laboratorio.

labName
path True

string

Nombre del laboratorio.

resourceGroupName
path True

string

Nombre del grupo de recursos.

subscriptionId
path True

string

Identificador de suscripción.

api-version
query True

string

Versión de la API de cliente.

Cuerpo de la solicitud

Nombre Tipo Description
location

string

La ubicación del recurso.

properties.configurationState

ConfigurationState

Describe el progreso del usuario en la configuración de su configuración de entorno.

properties.description

string

Describe el entorno y su configuración de recursos

properties.provisioningState

string

Estado de aprovisionamiento del recurso.

properties.resourceSettings

ResourceSettingsFragment

Configuración específica del recurso

properties.title

string

Título breve que describe el entorno y su configuración de recursos

properties.uniqueIdentifier

string

Identificador inmutable único de un recurso (Guid).

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

EnvironmentSetting

De acuerdo

Other Status Codes

CloudError

Solicitud incorrecta

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

Definiciones

Nombre Description
CloudError

Error de una solicitud REST.

CloudErrorBody

Cuerpo de un error de una solicitud REST.

ConfigurationState

Describe el progreso del usuario en la configuración de su configuración de entorno.

EnvironmentSetting

Representa la configuración de un entorno, desde el que se crearían instancias de entorno.

EnvironmentSettingFragment

Representa la configuración de un entorno, desde el que se crearían instancias de entorno.

LatestOperationResult

Detalles del estado de una operación.

ManagedLabVmSize

Tamaño de la máquina virtual

PublishingState

Describe la preparación de esta configuración de entorno.

ReferenceVm

Detalles de una máquina virtual de referencia

ReferenceVmFragment

Detalles de una máquina virtual de referencia

ResourceSettings

Representa la configuración específica del recurso.

ResourceSettingsFragment

Representa la configuración específica del recurso.

VmStateDetails

Detalles sobre el estado de la máquina virtual de referencia.

CloudError

Error de una solicitud REST.

Nombre Tipo Description
error

CloudErrorBody

Cuerpo de un error de una solicitud REST.

CloudErrorBody

Cuerpo de un error de una solicitud REST.

Nombre Tipo Description
code

string

details

CloudErrorBody[]

Errores internos.

message

string

target

string

ConfigurationState

Describe el progreso del usuario en la configuración de su configuración de entorno.

Valor Description
Completed

El usuario ha terminado de modificar la plantilla.

NotApplicable

El usuario no ha empezado a configurar su plantilla o no ha iniciado el proceso de configuración.

EnvironmentSetting

Representa la configuración de un entorno, desde el que se crearían instancias de entorno.

Nombre Tipo Description
id

string

Identificador del recurso.

location

string

La ubicación del recurso.

name

string

Nombre del recurso.

properties.configurationState

ConfigurationState

Describe el progreso del usuario en la configuración de su configuración de entorno.

properties.description

string

Describe el entorno y su configuración de recursos

properties.lastChanged

string (date-time)

Hora a la que se cambió por última vez la máquina virtual de plantilla.

properties.lastPublished

string (date-time)

Hora a la que se envió por última vez la máquina virtual de plantilla para su publicación.

properties.latestOperationResult

LatestOperationResult

Detalles de la operación más reciente. por ejemplo: status, error

properties.provisioningState

string

Estado de aprovisionamiento del recurso.

properties.publishingState

PublishingState

Describe la preparación de esta configuración de entorno.

properties.resourceSettings

ResourceSettings

Configuración específica del recurso

properties.title

string

Título breve que describe el entorno y su configuración de recursos

properties.uniqueIdentifier

string

Identificador inmutable único de un recurso (Guid).

tags

object

Etiquetas del recurso.

type

string

Tipo del recurso.

EnvironmentSettingFragment

Representa la configuración de un entorno, desde el que se crearían instancias de entorno.

Nombre Tipo Description
id

string

Identificador del recurso.

location

string

La ubicación del recurso.

name

string

Nombre del recurso.

properties.configurationState

ConfigurationState

Describe el progreso del usuario en la configuración de su configuración de entorno.

properties.description

string

Describe el entorno y su configuración de recursos

properties.provisioningState

string

Estado de aprovisionamiento del recurso.

properties.resourceSettings

ResourceSettingsFragment

Configuración específica del recurso

properties.title

string

Título breve que describe el entorno y su configuración de recursos

properties.uniqueIdentifier

string

Identificador inmutable único de un recurso (Guid).

tags

object

Etiquetas del recurso.

type

string

Tipo del recurso.

LatestOperationResult

Detalles del estado de una operación.

Nombre Tipo Description
errorCode

string

Código de error en caso de error.

errorMessage

string

Mensaje de error.

httpMethod

string

HttpMethod - PUT/POST/DELETE para la operación.

operationUrl

string

Dirección URL que se va a usar para comprobar el estado de la operación de ejecución prolongada

requestUri

string

URI de solicitud de la operación.

status

string

Estado actual de la operación.

ManagedLabVmSize

Tamaño de la máquina virtual

Valor Description
Basic

Tamaño de máquina virtual base

Performance

El tamaño de máquina virtual más eficaz

Standard

Tamaño de máquina virtual estándar o predeterminado

PublishingState

Describe la preparación de esta configuración de entorno.

Valor Description
Draft

Estado inicial de una configuración de entorno.

PublishFailed

No se pudieron aprovisionar todos los recursos necesarios.

Published

Todos los recursos están aprovisionados actualmente.

Publishing

Recursos de aprovisionamiento actuales.

Scaling

Actualmente, aprovisiona recursos sin volver a crear la imagen de máquina virtual.

ReferenceVm

Detalles de una máquina virtual de referencia

Nombre Tipo Description
password

string

Contraseña de la máquina virtual. Se establecerá en NULL en la API de recursos GET.

userName

string

Nombre de usuario de la máquina virtual

vmResourceId

string

Identificador de recurso de máquina virtual para el entorno

vmStateDetails

VmStateDetails

Los detalles de estado de la máquina virtual de referencia.

ReferenceVmFragment

Detalles de una máquina virtual de referencia

Nombre Tipo Description
password

string

Contraseña de la máquina virtual. Se establecerá en NULL en la API de recursos GET.

userName

string

Nombre de usuario de la máquina virtual

ResourceSettings

Representa la configuración específica del recurso.

Nombre Tipo Description
cores

integer (int32)

Núcleos de proceso traducidos de la máquina virtual

galleryImageResourceId

string

Identificador de recurso de la imagen de la galería que se usa para crear la máquina virtual.

id

string

Identificador único de la configuración del recurso

imageName

string

Nombre de la imagen utilizada para crear la configuración del entorno

referenceVm

ReferenceVm

Detalles específicos de la máquina virtual de referencia

size

ManagedLabVmSize

Tamaño de la máquina virtual

ResourceSettingsFragment

Representa la configuración específica del recurso.

Nombre Tipo Description
galleryImageResourceId

string

Identificador de recurso de la imagen de la galería que se usa para crear la máquina virtual.

referenceVm

ReferenceVmFragment

Detalles específicos de la máquina virtual de referencia

size

ManagedLabVmSize

Tamaño de la máquina virtual

VmStateDetails

Detalles sobre el estado de la máquina virtual de referencia.

Nombre Tipo Description
lastKnownPowerState

string

Último estado de potencia de proceso conocido capturado en DTL

powerState

string

Estado de energía de la máquina virtual de referencia.

rdpAuthority

string

La propiedad RdpAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para RDP (Protocolo de escritorio remoto).

sshAuthority

string

La propiedad SshAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para SSH.