Environments - Create Or Update

Skapa eller ersätt en befintlig miljö. Den här åtgärden tar ett tag att slutföra.

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

URI-parametrar

Name In Required Type Description
labName
path True
  • string

Namnet på labbet.

name
path True
  • string

Namnet på miljön.

resourceGroupName
path True
  • string

Namnet på resursgruppen.

subscriptionId
path True
  • string

Prenumerations-ID:t.

userName
path True
  • string

Namnet på användarprofilen.

api-version
query True
  • string

Klient-API-version.

Begärandetext

Name Type Description
location
  • string

Platsen för resursen.

properties.armTemplateDisplayName
  • string

Visningsnamnet för den Azure Resource Manager-mall som skapade miljön.

properties.deploymentProperties

Distributionsegenskaperna för miljön.

tags
  • object

Resursens taggar.

Svar

Name Type Description
200 OK

OK

201 Created

Skapad

Other Status Codes

BadRequest

Säkerhet

azure_auth

Implicit OAuth2-beviljande

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

Scopes

Name Description
user_impersonation Åtkomst Microsoft Azure

Exempel

Environments_CreateOrUpdate

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/users/@me/environments/{environmentName}?api-version=2018-09-15

{
  "properties": {
    "deploymentProperties": {
      "parameters": [],
      "armTemplateId": "/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/users/{uniqueIdentifier}/environments/{environmentName}",
  "name": "{environmentName}",
  "type": "Microsoft.DevTestLab/labs/users/environments",
  "location": "{location}",
  "properties": {
    "deploymentProperties": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    },
    "createdByUser": "user@contoso.com",
    "provisioningState": "Succeeded",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/users/{uniqueIdentifier}/environments/{environmentName}",
  "name": "{environmentName}",
  "type": "Microsoft.DevTestLab/labs/users/environments",
  "location": "{location}",
  "properties": {
    "deploymentProperties": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    },
    "createdByUser": "user@contoso.com",
    "provisioningState": "Creating",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Definitioner

ArmTemplateParameterProperties

Egenskaper för en Azure Resource Manager-mallparameter.

CloudError

Fel från en REST-begäran.

CloudErrorBody

Brödtext för ett fel från en REST-begäran.

DtlEnvironment

En miljö, som i princip är en ARM-malldistribution.

EnvironmentDeploymentProperties

Egenskaper för en miljödistribution.

ArmTemplateParameterProperties

Egenskaper för en Azure Resource Manager-mallparameter.

Name Type Description
name
  • string

Namnet på mallparametern.

value
  • string

Värdet för mallparametern.

CloudError

Fel från en REST-begäran.

Name Type Description
error

Molnfelet som inträffade

CloudErrorBody

Brödtext för ett fel från en REST-begäran.

Name Type Description
code
  • string

Felkoden.

details

Inre fel.

message
  • string

Felmeddelandet.

target
  • string

Felmålet.

DtlEnvironment

En miljö, som i princip är en ARM-malldistribution.

Name Type Description
id
  • string

Resursens identifierare.

location
  • string

Platsen för resursen.

name
  • string

Namnet på resursen.

properties.armTemplateDisplayName
  • string

Visningsnamnet för den Azure Resource Manager-mall som skapade miljön.

properties.createdByUser
  • string

Skaparen av miljön.

properties.deploymentProperties

Distributionsegenskaperna för miljön.

properties.provisioningState
  • string

Resursens etableringsstatus.

properties.resourceGroupId
  • string

Identifieraren för resursgruppen som innehåller miljöns resurser.

properties.uniqueIdentifier
  • string

Den unika oföränderliga identifieraren för en resurs (Guid).

tags
  • object

Resursens taggar.

type
  • string

Resurstypen.

EnvironmentDeploymentProperties

Egenskaper för en miljödistribution.

Name Type Description
armTemplateId
  • string

Azure Resource Manager-mallens identifierare.

parameters

Parametrarna för Azure Resource Manager-mallen.