Lab Plans - Create Or Update

Atualizações ou cria um recurso de Laboratório.
Operação para criar ou atualizar um recurso do Plano de Laboratório.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labPlans/{labPlanName}?api-version=2022-08-01

Parâmetros do URI

Name In Required Type Description
labPlanName
path True
  • string

O nome do plano de laboratório que o identifica exclusivamente dentro do grupo de recursos que contém recursos. Usado em URIs de recursos e em UI.

resourceGroupName
path True
  • string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.

subscriptionId
path True
  • string

A identificação da assinatura do alvo.

api-version
query True
  • string

A versão API a ser utilizada para esta operação.

Corpo do Pedido

Name Required Type Description
location True
  • string

A geolocalização onde o recurso vive

identity

Informação de Identidade Gerida

properties.allowedRegions
  • string[]

As regiões permitidas para o criador do laboratório usar ao criar laboratórios usando este plano de laboratório.

properties.defaultAutoShutdownProfile

O perfil de paragem do laboratório padrão. Isto pode ser alterado num recurso de laboratório e apenas fornece um perfil predefinido.

properties.defaultConnectionProfile

O perfil de ligação do laboratório padrão. Isto pode ser alterado num recurso de laboratório e apenas fornece um perfil predefinido.

properties.defaultNetworkProfile

O perfil da rede de planos de laboratório. Para impor as políticas de rede de laboratório, devem ser definidas aqui e não podem ser alteradas quando existem laboratórios existentes associados a este plano de laboratório.

properties.linkedLmsInstance
  • string

Url base da lms exemplo este plano de laboratório pode ligar as listas de laboratório contra.

properties.sharedGalleryId
  • string

Identificação de recursos da Shared Image Gallery anexa a este plano de laboratório. Ao guardar uma imagem de máquina virtual modelo de laboratório, esta será persistiu nesta galeria. Imagens partilhadas da galeria podem ser disponibilizadas para utilização na criação de novos laboratórios.

properties.supportInfo

Apoie informações de contacto e instruções para os utilizadores do plano de laboratório. Esta informação é apresentada aos proprietários de laboratórios e utilizadores de máquinas virtuais para todos os laboratórios do plano de laboratório.

tags
  • object

Etiquetas de recursos.

Respostas

Name Type Description
200 OK

A atualização foi bem sucedida; a resposta contém o Plano de Laboratório.

201 Created

A criação foi bem sucedida; a resposta contém o Plano de Laboratório.

202 Accepted

A atualização foi bem sucedida e tem uma longa operação em execução; a resposta contém o Plano de Laboratório.

Other Status Codes

A resposta por erro por defeito.

Exemplos

putLabPlan

Sample Request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan?api-version=2022-08-01

{
  "location": "westus",
  "properties": {
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}
Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Creating",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}
Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labPlans/testlabplan",
  "name": "testlabplan",
  "type": "Microsoft.LabServices/LabPlan",
  "location": "westus",
  "systemData": {
    "createdBy": "identity123",
    "createdByType": "User",
    "createdAt": "2020-05-01T10:00:00Z",
    "lastModifiedBy": "identity123",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-06-01T09:12:28Z"
  },
  "properties": {
    "provisioningState": "Updating",
    "defaultConnectionProfile": {
      "webSshAccess": "None",
      "webRdpAccess": "None",
      "clientSshAccess": "Public",
      "clientRdpAccess": "Public"
    },
    "defaultAutoShutdownProfile": {
      "shutdownOnDisconnect": "Enabled",
      "shutdownWhenNotConnected": "Enabled",
      "shutdownOnIdle": "UserAbsence",
      "disconnectDelay": "PT5M",
      "noConnectDelay": "PT5M",
      "idleDelay": "PT5M"
    },
    "defaultNetworkProfile": {
      "subnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"
    },
    "sharedGalleryId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Compute/galleries/testsig",
    "supportInfo": {
      "url": "help.contoso.com",
      "email": "help@contoso.com",
      "phone": "+1-202-555-0123",
      "instructions": "Contact support for help."
    }
  }
}

Definições

AutoShutdownProfile

Perfil para como lidar com o encerramento de máquinas virtuais.

ConnectionProfile

Perfil de ligação para a forma como os utilizadores se ligam a máquinas virtuais de laboratório.

ConnectionType

O nível de acesso ativado para acesso web sobre SSH.

createdByType

O tipo de identidade que criou o recurso.

EnableState

Se o encerramento da desconexão está ativado

ErrorAdditionalInfo

O erro de gestão de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

Identity

Identidade para o recurso.

LabPlan

Os planos de laboratório funcionam como um recipiente de permissão para criar laboratórios através de labs.azure.com. Além disso, podem fornecer um conjunto de configurações padrão que serão aplicadas no momento da criação de um laboratório, mas estes padrão ainda podem ser substituídos.

LabPlanNetworkProfile

Perfil para como lidar com a rede para planos de laboratório.

ProvisioningState

Estado atual do plano de laboratório.

ResourceIdentityType

O tipo de identidade.

shutdownOnIdleMode

Define se deve desligar o VM em marcha lenta e inativa e os critérios para a deteção inativa.

SupportInfo

Apoie informações e instruções de contacto.

systemData

Metadados relativos à criação e última modificação do recurso.

AutoShutdownProfile

Perfil para como lidar com o encerramento de máquinas virtuais.

Name Type Default Value Description
disconnectDelay
  • string

O tempo que um VM permanecerá em funcionamento após o utilizador desligar-se se este comportamento estiver ativado.

idleDelay
  • string

O tempo que um VM irá inativar antes de ser desligado se este comportamento estiver ativado.

noConnectDelay
  • string

O tempo que um VM permanecerá em funcionamento antes de ser desligado se não for feita nenhuma ligação e este comportamento estiver ativado.

shutdownOnDisconnect Disabled

Se o encerramento da desconexão está ativado

shutdownOnIdle None

Se um VM será desligado quando estiver despavendado por um período de tempo.

shutdownWhenNotConnected Disabled

Se um VM será desligado quando não estiver ligado após um período de tempo.

ConnectionProfile

Perfil de ligação para a forma como os utilizadores se ligam a máquinas virtuais de laboratório.

Name Type Default Value Description
clientRdpAccess None

O nível de acesso habilitado para acesso ao Cliente sobre RDP.

clientSshAccess None

O nível de acesso habilitado para acesso ao Cliente sobre SSH.

webRdpAccess None

O nível de acesso ativado para acesso web sobre RDP.

webSshAccess None

O nível de acesso ativado para acesso web sobre SSH.

ConnectionType

O nível de acesso ativado para acesso web sobre SSH.

Name Type Description
None
  • string
Private
  • string
Public
  • string

createdByType

O tipo de identidade que criou o recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

EnableState

Se o encerramento da desconexão está ativado

Name Type Description
Disabled
  • string
Enabled
  • string

ErrorAdditionalInfo

O erro de gestão de recursos informações adicionais.

Name Type Description
info
  • object

A informação adicional.

type
  • string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Type Description
additionalInfo

A informação adicional do erro.

code
  • string

O código de erro.

details

Os detalhes do erro.

message
  • string

A mensagem de erro.

target
  • string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Type Description
error

O objeto de erro.

Identity

Identidade para o recurso.

Name Type Description
principalId
  • string

A identificação principal da identidade dos recursos.

tenantId
  • string

A identidade do inquilino de recursos.

type

O tipo de identidade.

LabPlan

Os planos de laboratório funcionam como um recipiente de permissão para criar laboratórios através de labs.azure.com. Além disso, podem fornecer um conjunto de configurações padrão que serão aplicadas no momento da criação de um laboratório, mas estes padrão ainda podem ser substituídos.

Name Type Description
id
  • string

ID de recursos totalmente qualificado para o recurso. Ex - /subscrições/{subscriçãoD}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Informação de Identidade Gerida

location
  • string

A geolocalização onde o recurso vive

name
  • string

O nome do recurso

properties.allowedRegions
  • string[]

As regiões permitidas para o criador do laboratório usar ao criar laboratórios usando este plano de laboratório.

properties.defaultAutoShutdownProfile

O perfil de paragem do laboratório padrão. Isto pode ser alterado num recurso de laboratório e apenas fornece um perfil predefinido.

properties.defaultConnectionProfile

O perfil de ligação do laboratório padrão. Isto pode ser alterado num recurso de laboratório e apenas fornece um perfil predefinido.

properties.defaultNetworkProfile

O perfil da rede de planos de laboratório. Para impor as políticas de rede de laboratório, devem ser definidas aqui e não podem ser alteradas quando existem laboratórios existentes associados a este plano de laboratório.

properties.linkedLmsInstance
  • string

Url base da lms exemplo este plano de laboratório pode ligar as listas de laboratório contra.

properties.provisioningState

Estado atual do plano de laboratório.

properties.sharedGalleryId
  • string

Identificação de recursos da Shared Image Gallery anexa a este plano de laboratório. Ao guardar uma imagem de máquina virtual modelo de laboratório, esta será persistiu nesta galeria. Imagens partilhadas da galeria podem ser disponibilizadas para utilização na criação de novos laboratórios.

properties.supportInfo

Apoie informações de contacto e instruções para os utilizadores do plano de laboratório. Esta informação é apresentada aos proprietários de laboratórios e utilizadores de máquinas virtuais para todos os laboratórios do plano de laboratório.

systemData

Metadados relativos à criação e última modificação do plano de laboratório.

tags
  • object

Etiquetas de recursos.

type
  • string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

LabPlanNetworkProfile

Perfil para como lidar com a rede para planos de laboratório.

Name Type Description
subnetId
  • string

O id de recursos de sub-rede externo

ProvisioningState

Estado atual do plano de laboratório.

Name Type Description
Creating
  • string

O recurso está em vias de ser criado.

Deleting
  • string

O recurso está em vias de ser eliminado.

Failed
  • string

A operação anterior sobre o recurso falhou em deixar o recurso em estado pouco saudável.

Locked
  • string

O recurso está bloqueado e as alterações estão atualmente bloqueadas. Isto pode ser devido a manutenção ou a uma operação programada. O Estado voltará a ter sucesso quando a operação de bloqueio terminar.

Succeeded
  • string

O recurso encontra-se em estado saudável após a criação ou a operação de atualização.

Updating
  • string

Novos valores imobiliários estão a ser aplicados ao recurso.

ResourceIdentityType

O tipo de identidade.

Name Type Description
SystemAssigned
  • string

shutdownOnIdleMode

Define se deve desligar o VM em marcha lenta e inativa e os critérios para a deteção inativa.

Name Type Description
LowUsage
  • string

O VM será considerado inativo quando o utilizador estiver ausente e o consumo de recursos (CPU e disco) é reduzido.

None
  • string

O VM não será desligado quando estiver inativo.

UserAbsence
  • string

O VM será considerado inativo quando não houver entrada de teclado ou rato.

SupportInfo

Apoie informações e instruções de contacto.

Name Type Description
email
  • string

Suporte o endereço de e-mail de contato.

instructions
  • string

Instruções de apoio.

phone
  • string

Suporte o número de telefone do contato.

url
  • string

Suporte o endereço web.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Type Description
createdAt
  • string

O calendário da criação de recursos (UTC).

createdBy
  • string

A identidade que criou o recurso.

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt
  • string

O tempotampesso da última modificação de recursos (UTC)

lastModifiedBy
  • string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

O tipo de identidade que modificou o recurso pela última vez.