Environments - Create Or Update

Vytvořte nebo nahraďte existující prostředí. Tato operace může chvíli trvat.

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

Parametry identifikátoru URI

Name In Required Type Description
labName
path True
  • string

Název testovacího prostředí.

name
path True
  • string

Název prostředí.

resourceGroupName
path True
  • string

Název skupiny prostředků.

subscriptionId
path True
  • string

ID předplatného.

userName
path True
  • string

Jméno profilu uživatele.

api-version
query True
  • string

Verze rozhraní API klienta

Text požadavku

Name Type Description
location
  • string

Umístění prostředku.

properties.armTemplateDisplayName
  • string

Zobrazovaný název šablony Azure Resource Manager, která vytvořila prostředí.

properties.deploymentProperties

Vlastnosti nasazení prostředí.

tags
  • object

Značky prostředku.

Odpovědi

Name Type Description
200 OK

OK

201 Created

Vytvořeno

Other Status Codes

BadRequest

Zabezpečení

azure_auth

Implicitní udělení OAuth2

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

Scopes

Name Description
user_impersonation Access Microsoft Azure

Příklady

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

Definice

ArmTemplateParameterProperties

Vlastnosti parametru šablony Azure Resource Manager

CloudError

Chyba z požadavku REST.

CloudErrorBody

Text chyby z požadavku REST

DtlEnvironment

Prostředí, které je v podstatě nasazením šablony ARM.

EnvironmentDeploymentProperties

Vlastnosti nasazení prostředí

ArmTemplateParameterProperties

Vlastnosti parametru šablony Azure Resource Manager

Name Type Description
name
  • string

Název parametru šablony.

value
  • string

Hodnota parametru šablony.

CloudError

Chyba z požadavku REST.

Name Type Description
error

Chyba cloudu, ke které došlo

CloudErrorBody

Text chyby z požadavku REST

Name Type Description
code
  • string

Kód chyby

details

Vnitřní chyby.

message
  • string

Chybová zpráva

target
  • string

Cíl chyby.

DtlEnvironment

Prostředí, které je v podstatě nasazením šablony ARM.

Name Type Description
id
  • string

Identifikátor prostředku.

location
  • string

Umístění prostředku.

name
  • string

Název prostředku.

properties.armTemplateDisplayName
  • string

Zobrazovaný název šablony Azure Resource Manager, která vytvořila prostředí.

properties.createdByUser
  • string

Tvůrce prostředí.

properties.deploymentProperties

Vlastnosti nasazení prostředí.

properties.provisioningState
  • string

Stav zřizování prostředku.

properties.resourceGroupId
  • string

Identifikátor skupiny prostředků obsahující prostředky prostředí.

properties.uniqueIdentifier
  • string

Jedinečný neměnný identifikátor prostředku (GUID).

tags
  • object

Značky prostředku.

type
  • string

Typ prostředku.

EnvironmentDeploymentProperties

Vlastnosti nasazení prostředí

Name Type Description
armTemplateId
  • string

Identifikátor šablony azure Resource Manager

parameters

Parametry šablony Azure Resource Manager