Lab Accounts - Create Or Update

Service:

Lab Services

API Version:

2018-10-15

Create or replace an existing Lab Account.

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

URI Parameters

Name	In	Required	Type	Description
labAccountName	path	True	string	The name of the lab Account.
resourceGroupName	path	True	string	The name of the resource group.
subscriptionId	path	True	string	The subscription ID.
api-version	query	True	string	Client API version.

Request Body

Name	Type	Description
location	string	The location of the resource.
properties.enabledRegionSelection	boolean	Represents if region selection is enabled
properties.provisioningState	string	The provisioning status of the resource.
properties.uniqueIdentifier	string	The unique immutable identifier of a resource (Guid).
tags	object	The tags of the resource.

Responses

Name	Type	Description
200 OK	LabAccount	OK
201 Created	LabAccount	Created
Other Status Codes	CloudError	BadRequest

Security

azure_auth

OAuth2 Implicit Grant

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	Access Microsoft Azure

Definitions

Name	Description
CloudError	Error from a REST request.
CloudErrorBody	Body of an error from a REST request.
EnvironmentSize	Represents a size category supported by this Lab Account (small, medium or large)
LabAccount	Represents a lab account.
LatestOperationResult	Details of the status of an operation.
ManagedLabVmSize	The size of the virtual machine
SizeConfigurationProperties	Represents the size configuration under the lab account
SizeInfo	Contains detailed information about a size

CloudError

Error from a REST request.

Name	Type	Description
error	CloudErrorBody	Body of an error from a REST request.

CloudErrorBody

Body of an error from a REST request.

Name	Type	Description
code	string
details	CloudErrorBody[]	Inner errors.
message	string
target	string

EnvironmentSize

Represents a size category supported by this Lab Account (small, medium or large)

Name	Type	Description
maxPrice	number	The pay-as-you-go dollar price per hour this size will cost. It does not include discounts and may not reflect the actual price the size will cost. This is the maximum price of all prices within this tier.
minMemory	number	The amount of memory available (in GB). This is the minimum amount of memory within this tier.
minNumberOfCores	integer	The number of cores a VM of this size has. This is the minimum number of cores within this tier.
name	ManagedLabVmSize	The size category
vmSizes	SizeInfo[]	Represents a set of compute sizes that can serve this given size type

LabAccount

Represents a lab account.

Name	Type	Description
id	string	The identifier of the resource.
location	string	The location of the resource.
name	string	The name of the resource.
properties.enabledRegionSelection	boolean	Represents if region selection is enabled
properties.latestOperationResult	LatestOperationResult	The details of the latest operation. ex: status, error
properties.provisioningState	string	The provisioning status of the resource.
properties.sizeConfiguration	SizeConfigurationProperties	Represents the size configuration under the lab account
properties.uniqueIdentifier	string	The unique immutable identifier of a resource (Guid).
tags	object	The tags of the resource.
type	string	The type of the resource.

LatestOperationResult

Details of the status of an operation.

Name	Type	Description
errorCode	string	Error code on failure.
errorMessage	string	The error message.
httpMethod	string	The HttpMethod - PUT/POST/DELETE for the operation.
operationUrl	string	The URL to use to check long-running operation status
requestUri	string	Request URI of the operation.
status	string	The current status of the operation.

ManagedLabVmSize

The size of the virtual machine

Name	Type	Description
Basic	string	The base VM size
Performance	string	The most performant VM size
Standard	string	The standard or default VM size

SizeConfigurationProperties

Represents the size configuration under the lab account

Name	Type	Description
environmentSizes	EnvironmentSize[]	Represents a list of size categories supported by this Lab Account (Small, Medium, Large)

SizeInfo

Contains detailed information about a size

Name	Type	Description
computeSize	string	Represents the actual compute size, e.g. Standard_A2_v2.
memory	number	The amount of memory available (in GB).
numberOfCores	integer	The number of cores a VM of this size has.
price	number	The pay-as-you-go price per hour this size will cost. It does not include discounts and may not reflect the actual price the size will cost.