Delen via

Labs - Create Or Update

Service:
Dev Test Labs
API-versie:
2018-09-15

Een bestaand lab maken of vervangen. Het kan even duren voordat deze bewerking is voltooid.

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

URI-parameters

Name In Vereist Type Description
name
 path True

string

De naam van het lab.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId
 path True

string

minLength: 1

De id van het doelabonnement.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
location

string

De locatie van de resource.
properties.announcement

LabAnnouncementProperties

De eigenschappen van een labaankondiging die aan dit lab is gekoppeld
properties.environmentPermission

EnvironmentPermission

De toegangsrechten die aan de gebruiker moeten worden verleend bij het inrichten van een omgeving
properties.extendedProperties

object

Uitgebreide eigenschappen van het lab dat wordt gebruikt voor experimentele functies
properties.labStorageType

StorageType

Het type opslag dat door het lab wordt gebruikt. Het kan Premium of Standard zijn. De standaardwaarde is Premium.
properties.mandatoryArtifactsResourceIdsLinux

string[]

De geordende lijst met artefactresource-id's die standaard moeten worden toegepast op alle virtuele Linux-machines, vóór de artefacten die door de gebruiker zijn opgegeven.
properties.mandatoryArtifactsResourceIdsWindows

string[]

De geordende lijst met artefactresource-id's die standaard moeten worden toegepast op alle windows-VM-creaties, vóór de artefacten die door de gebruiker zijn opgegeven.
properties.premiumDataDisks

PremiumDataDisk

De instelling voor het inschakelen van het gebruik van Premium-gegevensschijven. Wanneer de waarde Ingeschakeld is, is het maken van standard- of Premium-gegevensschijven toegestaan. Wanneer de waarde uitgeschakeld is, is alleen het maken van standaardgegevensschijven toegestaan.
properties.support

LabSupportProperties

De eigenschappen van een ondersteuningsbericht voor lab's dat aan dit lab is gekoppeld
tags

object

De tags van de resource.

Antwoorden

Name Type Description
200 OK

Lab

De updatebewerking van de resource 'Lab' is geslaagd
201 Created

Lab

Resource 'Lab' create operatie geslaagd

Kopteksten

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Labs_CreateOrUpdate

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
EnableStatus

Geeft aan of de artefactbron is ingeschakeld (waarden: Ingeschakeld, Uitgeschakeld).
EnvironmentPermission

De toegangsrechten die aan de gebruiker moeten worden verleend bij het inrichten van een omgeving
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
Lab

Een lab.
LabAnnouncementProperties

Eigenschappen van de aankondigingsbanner van een lab
LabSupportProperties

Eigenschappen van de ondersteuningsbanner van een lab
PremiumDataDisk

De instelling voor het inschakelen van het gebruik van Premium-gegevensschijven. Wanneer de waarde Ingeschakeld is, is het maken van standard- of Premium-gegevensschijven toegestaan. Wanneer de waarde uitgeschakeld is, is alleen het maken van standaardgegevensschijven toegestaan.
StorageType

Het opslagtype voor de schijf (bijvoorbeeld Standard, Premium).

EnableStatus

Inventarisatie

Geeft aan of de artefactbron is ingeschakeld (waarden: Ingeschakeld, Uitgeschakeld).

Waarde Description
Enabled
Disabled

EnvironmentPermission

Inventarisatie

De toegangsrechten die aan de gebruiker moeten worden verleend bij het inrichten van een omgeving

Waarde Description
Reader
Contributor

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

Lab

Object

Een lab.

Name Type Default value Description
id

string

De id van de resource.
location

string

De locatie van de resource.
name

string

De naam van de resource.
properties.announcement

LabAnnouncementProperties

De eigenschappen van een labaankondiging die aan dit lab is gekoppeld
properties.artifactsStorageAccount

string

Het opslagaccount voor artefacten van het lab.
properties.createdDate

string (date-time)

De aanmaakdatum van het lab.
properties.defaultPremiumStorageAccount

string

Het standaard premium-opslagaccount van het lab.
properties.defaultStorageAccount

string

Het standaardopslagaccount van het lab.
properties.environmentPermission

EnvironmentPermission

De toegangsrechten die aan de gebruiker moeten worden verleend bij het inrichten van een omgeving
properties.extendedProperties

object

Uitgebreide eigenschappen van het lab dat wordt gebruikt voor experimentele functies
properties.labStorageType

StorageType

Premium

Het type opslag dat door het lab wordt gebruikt. Het kan Premium of Standard zijn. De standaardwaarde is Premium.
properties.loadBalancerId

string

De load balancer die wordt gebruikt voor lab-VM's die gebruikmaken van een gedeeld IP-adres.
properties.mandatoryArtifactsResourceIdsLinux

string[]

De geordende lijst met artefactresource-id's die standaard moeten worden toegepast op alle virtuele Linux-machines, vóór de artefacten die door de gebruiker zijn opgegeven.
properties.mandatoryArtifactsResourceIdsWindows

string[]

De geordende lijst met artefactresource-id's die standaard moeten worden toegepast op alle windows-VM-creaties, vóór de artefacten die door de gebruiker zijn opgegeven.
properties.networkSecurityGroupId

string

De netwerkbeveiligingsgroep die is gekoppeld aan de netwerkinterfaces van de lab-VM's om open poorten te beperken.
properties.premiumDataDiskStorageAccount

string

Het premium-opslagaccount voor gegevensschijven van het lab.
properties.premiumDataDisks

PremiumDataDisk

De instelling voor het inschakelen van het gebruik van Premium-gegevensschijven. Wanneer de waarde Ingeschakeld is, is het maken van standard- of Premium-gegevensschijven toegestaan. Wanneer de waarde uitgeschakeld is, is alleen het maken van standaardgegevensschijven toegestaan.
properties.provisioningState

string

De inrichtingsstatus van de resource.
properties.publicIpId

string

Het openbare IP-adres voor de load balancer van het lab.
properties.support

LabSupportProperties

De eigenschappen van een ondersteuningsbericht voor lab's dat aan dit lab is gekoppeld
properties.uniqueIdentifier

string

De unieke onveranderbare id van een resource (GUID).
properties.vaultName

string

De sleutelkluis van het lab.
properties.vmCreationResourceGroup

string

De resourcegroep waarin alle nieuwe virtuele labmachines worden gemaakt. Als u wilt toestaan dat DevTest Labs het maken van resourcegroepen beheert, stelt u deze waarde in op null.
tags

object

De tags van de resource.
type

string

Het type resource.

LabAnnouncementProperties

Object

Eigenschappen van de aankondigingsbanner van een lab

Name Type Description
enabled

EnableStatus

Is de labaankondiging op dit moment actief/ingeschakeld?
expirationDate

string (date-time)

Het tijdstip waarop de aankondiging verloopt (null voor nooit)
expired

boolean

Is deze aankondiging verlopen?
markdown

string

De markdown-tekst (indien aanwezig) die in dit lab wordt weergegeven in de gebruikersinterface. Als u niets leeg/null laat, wordt er niets weergegeven.
provisioningState

string

De inrichtingsstatus van de resource.
title

string

De titel van de tekst zonder opmaak voor de aankondiging van het lab
uniqueIdentifier

string

De unieke onveranderbare id van een resource (GUID).

LabSupportProperties

Object

Eigenschappen van de ondersteuningsbanner van een lab

Name Type Description
enabled

EnableStatus

Is de banner voor labondersteuning op dit moment actief/ingeschakeld?
markdown

string

De markdown-tekst (indien aanwezig) die in dit lab wordt weergegeven in de gebruikersinterface. Als u niets leeg/null laat, wordt er niets weergegeven.

PremiumDataDisk

Inventarisatie

De instelling voor het inschakelen van het gebruik van Premium-gegevensschijven. Wanneer de waarde Ingeschakeld is, is het maken van standard- of Premium-gegevensschijven toegestaan. Wanneer de waarde uitgeschakeld is, is alleen het maken van standaardgegevensschijven toegestaan.

Waarde Description
Disabled
Enabled

StorageType

Inventarisatie

Het opslagtype voor de schijf (bijvoorbeeld Standard, Premium).

Waarde Description
Standard
Premium
StandardSSD