Labs - Create Or Update

Serviço:: Dev Test Labs

Versão da API:: 2018-09-15

Crie ou substitua um laboratório existente. Esta operação pode demorar algum tempo a concluir.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
name	path	True	string	O nome do laboratório.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
location	string	A localização do recurso.
properties.announcement	LabAnnouncementProperties	As propriedades de qualquer anúncio de laboratório associado a este laboratório
properties.environmentPermission	EnvironmentPermission	Os direitos de acesso a serem concedidos ao usuário ao provisionar um ambiente
properties.extendedProperties	object	Propriedades estendidas do laboratório usadas para recursos experimentais
properties.labStorageType	StorageType	Tipo de armazenamento utilizado pelo laboratório. Pode ser Premium ou Standard. O padrão é Premium.
properties.mandatoryArtifactsResourceIdsLinux	string[]	A lista ordenada de IDs de recursos de artefato que devem ser aplicados em todas as criações de VM Linux por padrão, antes dos artefatos especificados pelo usuário.
properties.mandatoryArtifactsResourceIdsWindows	string[]	A lista ordenada de IDs de recursos de artefato que devem ser aplicadas em todas as criações de VM do Windows por padrão, antes dos artefatos especificados pelo usuário.
properties.premiumDataDisks	PremiumDataDisk	A configuração para habilitar o uso de discos de dados premium. Quando o seu valor é 'Ativado', a criação de discos de dados padrão ou premium é permitida. Quando seu valor é 'Desativado', somente a criação de discos de dados padrão é permitida.
properties.support	LabSupportProperties	As propriedades de qualquer mensagem de suporte de laboratório associada a este laboratório
tags	object	As tags do recurso.

Respostas

Name	Tipo	Description
200 OK	Lab	Operação de atualização do 'Lab' de recursos bem-sucedida
201 Created	Lab	Recurso 'Lab' criar operação bem-sucedida Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Name

Tipo

Description

200 OK

Lab

Operação de atualização do 'Lab' de recursos bem-sucedida

201 Created

Lab

Recurso 'Lab' criar operação bem-sucedida

Cabeçalhos

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Labs_CreateOrUpdate

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Definições

Name	Description
EnableStatus	Indica se a origem do artefato está habilitada (valores: Habilitado, Desabilitado).
EnvironmentPermission	Os direitos de acesso a serem concedidos ao usuário ao provisionar um ambiente
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
Lab	Um laboratório.
LabAnnouncementProperties	Propriedades do banner de anúncio de um laboratório
LabSupportProperties	Propriedades do banner de suporte de um laboratório
PremiumDataDisk	A configuração para habilitar o uso de discos de dados premium. Quando o seu valor é 'Ativado', a criação de discos de dados padrão ou premium é permitida. Quando seu valor é 'Desativado', somente a criação de discos de dados padrão é permitida.
StorageType	O tipo de armazenamento para o disco (ou seja, Standard, Premium).

EnableStatus

Enumeração

Indica se a origem do artefato está habilitada (valores: Habilitado, Desabilitado).

Valor	Description
Enabled
Disabled

EnvironmentPermission

Enumeração

Os direitos de acesso a serem concedidos ao usuário ao provisionar um ambiente

Valor	Description
Reader
Contributor

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

Lab

Object

Um laboratório.

Name	Tipo	Default value	Description
id	string		O identificador do recurso.
location	string		A localização do recurso.
name	string		O nome do recurso.
properties.announcement	LabAnnouncementProperties		As propriedades de qualquer anúncio de laboratório associado a este laboratório
properties.artifactsStorageAccount	string		Conta de armazenamento de artefactos do laboratório.
properties.createdDate	string (date-time)		A data de criação do laboratório.
properties.defaultPremiumStorageAccount	string		A conta de armazenamento premium padrão do laboratório.
properties.defaultStorageAccount	string		A conta de armazenamento padrão do laboratório.
properties.environmentPermission	EnvironmentPermission		Os direitos de acesso a serem concedidos ao usuário ao provisionar um ambiente
properties.extendedProperties	object		Propriedades estendidas do laboratório usadas para recursos experimentais
properties.labStorageType	StorageType	Premium	Tipo de armazenamento utilizado pelo laboratório. Pode ser Premium ou Standard. O padrão é Premium.
properties.loadBalancerId	string		O balanceador de carga usado para VMs de laboratório que usam endereço IP compartilhado.
properties.mandatoryArtifactsResourceIdsLinux	string[]		A lista ordenada de IDs de recursos de artefato que devem ser aplicados em todas as criações de VM Linux por padrão, antes dos artefatos especificados pelo usuário.
properties.mandatoryArtifactsResourceIdsWindows	string[]		A lista ordenada de IDs de recursos de artefato que devem ser aplicadas em todas as criações de VM do Windows por padrão, antes dos artefatos especificados pelo usuário.
properties.networkSecurityGroupId	string		O Grupo de Segurança de Rede anexado às interfaces de rede de VMs de laboratório para restringir portas abertas.
properties.premiumDataDiskStorageAccount	string		Conta premium de armazenamento em disco de dados do laboratório.
properties.premiumDataDisks	PremiumDataDisk		A configuração para habilitar o uso de discos de dados premium. Quando o seu valor é 'Ativado', a criação de discos de dados padrão ou premium é permitida. Quando seu valor é 'Desativado', somente a criação de discos de dados padrão é permitida.
properties.provisioningState	string		O status de provisionamento do recurso.
properties.publicIpId	string		O endereço IP público do balanceador de carga do laboratório.
properties.support	LabSupportProperties		As propriedades de qualquer mensagem de suporte de laboratório associada a este laboratório
properties.uniqueIdentifier	string		O identificador único imutável de um recurso (Guid).
properties.vaultName	string		Cofre de chaves do laboratório.
properties.vmCreationResourceGroup	string		O grupo de recursos no qual todas as novas máquinas virtuais de laboratório serão criadas. Para permitir que o DevTest Labs gerencie a criação de grupos de recursos, defina esse valor como null.
tags	object		As tags do recurso.
type	string		O tipo do recurso.

LabAnnouncementProperties

Object

Propriedades do banner de anúncio de um laboratório

Name	Tipo	Description
enabled	EnableStatus	O anúncio do laboratório está ativo/ativado neste momento?
expirationDate	string (date-time)	O momento em que o anúncio expira (nulo por nunca)
expired	boolean	Este anúncio expirou?
markdown	string	O texto de marcação (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado.
provisioningState	string	O status de provisionamento do recurso.
title	string	O título de texto simples para o anúncio do laboratório
uniqueIdentifier	string	O identificador único imutável de um recurso (Guid).

LabSupportProperties

Object

Propriedades do banner de suporte de um laboratório

Name	Tipo	Description
enabled	EnableStatus	O banner de suporte do laboratório está ativo/ativado no momento?
markdown	string	O texto de marcação (se houver) que este laboratório exibe na interface do usuário. Se deixado vazio/nulo, nada será mostrado.

PremiumDataDisk

Enumeração

A configuração para habilitar o uso de discos de dados premium. Quando o seu valor é 'Ativado', a criação de discos de dados padrão ou premium é permitida. Quando seu valor é 'Desativado', somente a criação de discos de dados padrão é permitida.

Valor	Description
Disabled
Enabled

StorageType

Enumeração

O tipo de armazenamento para o disco (ou seja, Standard, Premium).

Valor	Description
Standard
Premium
StandardSSD

Partilhar via

Labs - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Labs_CreateOrUpdate

Pedido de amostra

Resposta da amostra

Definições

EnableStatus

EnvironmentPermission

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Lab

LabAnnouncementProperties

LabSupportProperties

PremiumDataDisk

StorageType