Labs - Create Or Update

Tjänst:: Dev Test Labs

API-version:: 2018-09-15

Skapa eller ersätt ett befintligt labb. Den här åtgärden kan ta en stund att slutföra.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
name	path	True	string	Namnet på labbet.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
location	string	Platsen för resursen.
properties.announcement	LabAnnouncementProperties	Egenskaperna för eventuella labbmeddelanden som är associerade med det här labbet
properties.environmentPermission	EnvironmentPermission	De åtkomsträttigheter som ska beviljas användaren vid etablering av en miljö
properties.extendedProperties	object	Utökade egenskaper för labbet som används för experimentella funktioner
properties.labStorageType	StorageType	Typ av lagring som används av labbet. Det kan vara antingen Premium eller Standard. Standardvärdet är Premium.
properties.mandatoryArtifactsResourceIdsLinux	string[]	Den ordnade listan över artefaktresurs-ID:n som ska tillämpas på alla skapanden av virtuella Linux-datorer som standard, innan de artefakter som anges av användaren.
properties.mandatoryArtifactsResourceIdsWindows	string[]	Den ordnade listan över artefaktresurs-ID:n som ska tillämpas på alla skapanden av virtuella Windows-datorer som standard, innan de artefakter som anges av användaren.
properties.premiumDataDisks	PremiumDataDisk	Inställningen för att aktivera användning av Premium-datadiskar. När värdet är "Aktiverat" tillåts skapande av standard- eller Premium-datadiskar. När värdet är Inaktiverat tillåts endast skapande av standarddatadiskar.
properties.support	LabSupportProperties	Egenskaperna för eventuella labbsupportmeddelanden som är associerade med den här labbuppgiften
tags	object	Taggarna för resursen.

Svar

Name	Typ	Description
200 OK	Lab	Uppdateringsåtgärden för resursen "Lab" lyckades
201 Created	Lab	Åtgärden för att skapa resursen "Lab" lyckades Sidhuvuden Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

Lab

Uppdateringsåtgärden för resursen "Lab" lyckades

201 Created

Lab

Åtgärden för att skapa resursen "Lab" lyckades

Sidhuvuden

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Labs_CreateOrUpdate

Exempelbegäran

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

Exempelsvar

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

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

Definitioner

Name	Description
EnableStatus	Anger om artefaktkällan är aktiverad (värden: Aktiverad, Inaktiverad).
EnvironmentPermission	De åtkomsträttigheter som ska beviljas användaren vid etablering av en miljö
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
Lab	Ett labb.
LabAnnouncementProperties	Egenskaper för en labbmeddelandebanderoll
LabSupportProperties	Egenskaper för ett labbs supportbanderoll
PremiumDataDisk	Inställningen för att aktivera användning av Premium-datadiskar. När värdet är "Aktiverat" tillåts skapande av standard- eller Premium-datadiskar. När värdet är Inaktiverat tillåts endast skapande av standarddatadiskar.
StorageType	Lagringstypen för disken (dvs. Standard, Premium).

EnableStatus

Uppräkning

Anger om artefaktkällan är aktiverad (värden: Aktiverad, Inaktiverad).

Värde	Description
Enabled
Disabled

EnvironmentPermission

Uppräkning

De åtkomsträttigheter som ska beviljas användaren vid etablering av en miljö

Värde	Description
Reader
Contributor

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

Lab

Objekt

Ett labb.

Name	Typ	Standardvärde	Description
id	string		Resursens identifierare.
location	string		Platsen för resursen.
name	string		Namnet på resursen.
properties.announcement	LabAnnouncementProperties		Egenskaperna för eventuella labbmeddelanden som är associerade med det här labbet
properties.artifactsStorageAccount	string		Labbets artefaktlagringskonto.
properties.createdDate	string (date-time)		Skapandedatumet för labbet.
properties.defaultPremiumStorageAccount	string		Labbets standardkonto för premiumlagring.
properties.defaultStorageAccount	string		Labbets standardlagringskonto.
properties.environmentPermission	EnvironmentPermission		De åtkomsträttigheter som ska beviljas användaren vid etablering av en miljö
properties.extendedProperties	object		Utökade egenskaper för labbet som används för experimentella funktioner
properties.labStorageType	StorageType	Premium	Typ av lagring som används av labbet. Det kan vara antingen Premium eller Standard. Standardvärdet är Premium.
properties.loadBalancerId	string		Lastbalanseraren som används för virtuella labbdatorer som använder delad IP-adress.
properties.mandatoryArtifactsResourceIdsLinux	string[]		Den ordnade listan över artefaktresurs-ID:n som ska tillämpas på alla skapanden av virtuella Linux-datorer som standard, innan de artefakter som anges av användaren.
properties.mandatoryArtifactsResourceIdsWindows	string[]		Den ordnade listan över artefaktresurs-ID:n som ska tillämpas på alla skapanden av virtuella Windows-datorer som standard, innan de artefakter som anges av användaren.
properties.networkSecurityGroupId	string		Nätverkssäkerhetsgruppen som är kopplad till labb-VM:ernas nätverksgränssnitt för att begränsa öppna portar.
properties.premiumDataDiskStorageAccount	string		Labbets Premium-lagringskonto för datadiskar.
properties.premiumDataDisks	PremiumDataDisk		Inställningen för att aktivera användning av Premium-datadiskar. När värdet är "Aktiverat" tillåts skapande av standard- eller Premium-datadiskar. När värdet är Inaktiverat tillåts endast skapande av standarddatadiskar.
properties.provisioningState	string		Resursens etableringsstatus.
properties.publicIpId	string		Den offentliga IP-adressen för labbets lastbalanserare.
properties.support	LabSupportProperties		Egenskaperna för eventuella labbsupportmeddelanden som är associerade med den här labbuppgiften
properties.uniqueIdentifier	string		Den unika oföränderliga identifieraren för en resurs (Guid).
properties.vaultName	string		Labbets nyckelvalv.
properties.vmCreationResourceGroup	string		Resursgruppen där alla nya virtuella labbdatorer skapas. Om du vill låta DevTest Labs hantera skapande av resursgrupper anger du värdet till null.
tags	object		Taggarna för resursen.
type	string		Resurstypen.

LabAnnouncementProperties

Objekt

Egenskaper för en labbmeddelandebanderoll

Name	Typ	Description
enabled	EnableStatus	Är labbmeddelandet aktivt/aktiverat just nu?
expirationDate	string (date-time)	Tiden då meddelandet upphör att gälla (null för aldrig)
expired	boolean	Har det här meddelandet upphört att gälla?
markdown	string	Markdown-texten (om någon) som den här labbuppgiften visar i användargränssnittet. Om inget lämnas tomt/null visas ingenting.
provisioningState	string	Resursens etableringsstatus.
title	string	Oformaterad textrubrik för labbmeddelandet
uniqueIdentifier	string	Den unika oföränderliga identifieraren för en resurs (Guid).

LabSupportProperties

Objekt

Egenskaper för ett labbs supportbanderoll

Name	Typ	Description
enabled	EnableStatus	Är labbsupporten aktiv/aktiverad just nu?
markdown	string	Markdown-texten (om någon) som den här labbuppgiften visar i användargränssnittet. Om inget lämnas tomt/null visas ingenting.

PremiumDataDisk

Uppräkning

Inställningen för att aktivera användning av Premium-datadiskar. När värdet är "Aktiverat" tillåts skapande av standard- eller Premium-datadiskar. När värdet är Inaktiverat tillåts endast skapande av standarddatadiskar.

Värde	Description
Disabled
Enabled

StorageType

Uppräkning

Lagringstypen för disken (dvs. Standard, Premium).

Värde	Description
Standard
Premium
StandardSSD

Dela via

Labs - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Labs_CreateOrUpdate

Exempelbegäran

Exempelsvar

Definitioner

EnableStatus

EnvironmentPermission

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Lab

LabAnnouncementProperties

LabSupportProperties

PremiumDataDisk

StorageType