Labs - Create Or Update

Servicio:: Dev Test Labs

Versión de la API:: 2018-09-15

Cree o reemplace un laboratorio existente. Esta operación puede tardar un tiempo en completarse.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}?api-version=2018-09-15

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
name	path	True	string	Nombre del laboratorio.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
location	string	La ubicación del recurso.
properties.announcement	LabAnnouncementProperties	Propiedades de cualquier anuncio de laboratorio asociado a este laboratorio
properties.environmentPermission	EnvironmentPermission	Derechos de acceso que se van a conceder al usuario al aprovisionar un entorno
properties.extendedProperties	object	Propiedades extendidas del laboratorio usadas para características experimentales
properties.labStorageType	StorageType	Tipo de almacenamiento usado por el laboratorio. Puede ser Premium o Estándar. El valor predeterminado es Premium.
properties.mandatoryArtifactsResourceIdsLinux	string[]	Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Linux de forma predeterminada, antes de los artefactos especificados por el usuario.
properties.mandatoryArtifactsResourceIdsWindows	string[]	Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Windows de forma predeterminada, antes de los artefactos especificados por el usuario.
properties.premiumDataDisks	PremiumDataDisk	Configuración para habilitar el uso de discos de datos Premium. Cuando su valor es "Habilitado", se permite la creación de discos de datos estándar o Premium. Cuando su valor es "Disabled", solo se permite la creación de discos de datos estándar.
properties.support	LabSupportProperties	Propiedades de cualquier mensaje de soporte técnico de laboratorio asociado a este laboratorio
tags	object	Etiquetas del recurso.

Respuestas

Nombre	Tipo	Description
200 OK	Lab	Operación de actualización de recursos "Lab" correcta
201 Created	Lab	Operación de creación de recursos "Lab" realizada correctamente Encabezados Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

Lab

Operación de actualización de recursos "Lab" correcta

201 Created

Lab

Operación de creación de recursos "Lab" realizada correctamente

Encabezados

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory.

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

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Labs_CreateOrUpdate

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}?api-version=2018-09-15

{
  "location": "{location}",
  "properties": {
    "labStorageType": "{Standard|Premium}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Respuesta de muestra

status code:: 200

{
  "name": "{labName}",
  "type": "Microsoft.DevTestLab/labs",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
  "location": "{location}",
  "properties": {
    "announcement": {
      "enabled": "Disabled",
      "expired": false,
      "markdown": "",
      "title": ""
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "environmentPermission": "Reader",
    "labStorageType": "Standard",
    "mandatoryArtifactsResourceIdsLinux": [],
    "mandatoryArtifactsResourceIdsWindows": [],
    "premiumDataDisks": "Disabled",
    "provisioningState": "Creating",
    "support": {
      "enabled": "Disabled",
      "markdown": ""
    },
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

status code:: 201

{
  "name": "{labName}",
  "type": "Microsoft.DevTestLab/labs",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
  "location": "{location}",
  "properties": {
    "announcement": {
      "enabled": "Disabled",
      "expired": false,
      "markdown": "",
      "title": ""
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "environmentPermission": "Reader",
    "labStorageType": "Standard",
    "mandatoryArtifactsResourceIdsLinux": [],
    "mandatoryArtifactsResourceIdsWindows": [],
    "premiumDataDisks": "Disabled",
    "provisioningState": "Creating",
    "support": {
      "enabled": "Disabled",
      "markdown": ""
    },
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Definiciones

Nombre	Description
EnableStatus	Indica si el origen del artefacto está habilitado (valores: Habilitado, Deshabilitado).
EnvironmentPermission	Derechos de acceso que se van a conceder al usuario al aprovisionar un entorno
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
Lab	Un laboratorio.
LabAnnouncementProperties	Propiedades del banner de anuncio de un laboratorio
LabSupportProperties	Propiedades del banner de soporte técnico de un laboratorio
PremiumDataDisk	Configuración para habilitar el uso de discos de datos Premium. Cuando su valor es "Habilitado", se permite la creación de discos de datos estándar o Premium. Cuando su valor es "Disabled", solo se permite la creación de discos de datos estándar.
StorageType	Tipo de almacenamiento para el disco (es decir, Estándar, Premium).

EnableStatus

Enumeración

Indica si el origen del artefacto está habilitado (valores: Habilitado, Deshabilitado).

Valor	Description
Enabled
Disabled

EnvironmentPermission

Enumeración

Derechos de acceso que se van a conceder al usuario al aprovisionar un entorno

Valor	Description
Reader
Contributor

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

Lab

Object

Un laboratorio.

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador del recurso.
location	string		La ubicación del recurso.
name	string		Nombre del recurso.
properties.announcement	LabAnnouncementProperties		Propiedades de cualquier anuncio de laboratorio asociado a este laboratorio
properties.artifactsStorageAccount	string		Cuenta de almacenamiento de artefactos del laboratorio.
properties.createdDate	string (date-time)		Fecha de creación del laboratorio.
properties.defaultPremiumStorageAccount	string		La cuenta de premium storage predeterminada del laboratorio.
properties.defaultStorageAccount	string		La cuenta de almacenamiento predeterminada del laboratorio.
properties.environmentPermission	EnvironmentPermission		Derechos de acceso que se van a conceder al usuario al aprovisionar un entorno
properties.extendedProperties	object		Propiedades extendidas del laboratorio usadas para características experimentales
properties.labStorageType	StorageType	Premium	Tipo de almacenamiento usado por el laboratorio. Puede ser Premium o Estándar. El valor predeterminado es Premium.
properties.loadBalancerId	string		Equilibrador de carga que se usa para las máquinas virtuales de laboratorio que usan la dirección IP compartida.
properties.mandatoryArtifactsResourceIdsLinux	string[]		Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Linux de forma predeterminada, antes de los artefactos especificados por el usuario.
properties.mandatoryArtifactsResourceIdsWindows	string[]		Lista ordenada de identificadores de recursos de artefacto que se deben aplicar en todas las creaciones de máquinas virtuales Windows de forma predeterminada, antes de los artefactos especificados por el usuario.
properties.networkSecurityGroupId	string		El grupo de seguridad de red conectado a las interfaces de red de las máquinas virtuales del laboratorio para restringir los puertos abiertos.
properties.premiumDataDiskStorageAccount	string		Cuenta de almacenamiento en disco de datos Premium del laboratorio.
properties.premiumDataDisks	PremiumDataDisk		Configuración para habilitar el uso de discos de datos Premium. Cuando su valor es "Habilitado", se permite la creación de discos de datos estándar o Premium. Cuando su valor es "Disabled", solo se permite la creación de discos de datos estándar.
properties.provisioningState	string		Estado de aprovisionamiento del recurso.
properties.publicIpId	string		Dirección IP pública del equilibrador de carga del laboratorio.
properties.support	LabSupportProperties		Propiedades de cualquier mensaje de soporte técnico de laboratorio asociado a este laboratorio
properties.uniqueIdentifier	string		Identificador inmutable único de un recurso (Guid).
properties.vaultName	string		Almacén de claves del laboratorio.
properties.vmCreationResourceGroup	string		Grupo de recursos en el que se crearán todas las máquinas virtuales de laboratorio nuevas. Para permitir que DevTest Labs administre la creación del grupo de recursos, establezca este valor en NULL.
tags	object		Etiquetas del recurso.
type	string		Tipo del recurso.

LabAnnouncementProperties

Object

Propiedades del banner de anuncio de un laboratorio

Nombre	Tipo	Description
enabled	EnableStatus	¿El anuncio del laboratorio está activo o habilitado en este momento?
expirationDate	string (date-time)	Hora a la que expira el anuncio (null para nunca)
expired	boolean	¿Ha expirado este anuncio?
markdown	string	Texto markdown (si existe) que este laboratorio muestra en la interfaz de usuario. Si se deja vacío o nulo, no se mostrará nada.
provisioningState	string	Estado de aprovisionamiento del recurso.
title	string	Título de texto sin formato del anuncio del laboratorio
uniqueIdentifier	string	Identificador inmutable único de un recurso (Guid).

LabSupportProperties

Object

Propiedades del banner de soporte técnico de un laboratorio

Nombre	Tipo	Description
enabled	EnableStatus	¿El banner de soporte técnico del laboratorio está activo o habilitado en este momento?
markdown	string	Texto markdown (si existe) que este laboratorio muestra en la interfaz de usuario. Si se deja vacío o nulo, no se mostrará nada.

PremiumDataDisk

Enumeración

Configuración para habilitar el uso de discos de datos Premium. Cuando su valor es "Habilitado", se permite la creación de discos de datos estándar o Premium. Cuando su valor es "Disabled", solo se permite la creación de discos de datos estándar.

Valor	Description
Disabled
Enabled

StorageType

Enumeración

Tipo de almacenamiento para el disco (es decir, Estándar, Premium).

Valor	Description
Standard
Premium
StandardSSD

Compartir a través de

Labs - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Labs_CreateOrUpdate

Solicitud de ejemplo

Respuesta de muestra

Definiciones

EnableStatus

EnvironmentPermission

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Lab

LabAnnouncementProperties

LabSupportProperties

PremiumDataDisk

StorageType