Sdílet prostřednictvím


Environments - Create Or Update

Vytvoření nebo nahrazení existujícího 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 V Vyžadováno Typ 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

Název profilu uživatele.

api-version
query True

string

Verze rozhraní API klienta.

Text požadavku

Name Typ Description
location

string

Umístění prostředku.

properties.armTemplateDisplayName

string

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

properties.deploymentProperties

EnvironmentDeploymentProperties

Vlastnosti nasazení prostředí.

tags

object

Značky prostředku.

Odpovědi

Name Typ Description
200 OK

DtlEnvironment

OK

201 Created

DtlEnvironment

Vytvořeno

Other Status Codes

CloudError

BadRequest

Zabezpečení

azure_auth

Implicitní udělení OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation Přístup k Microsoft Azure

Příklady

Environments_CreateOrUpdate

Ukázkový požadavek

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

Ukázková odpověď

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

Name Description
ArmTemplateParameterProperties

Vlastnosti parametru šablony Azure Resource Manager.

CloudError

Chyba požadavku REST.

CloudErrorBody

Text chyby z požadavku REST

DtlEnvironment

Prostředí, což je v podstatě nasazení šablony ARM.

EnvironmentDeploymentProperties

Vlastnosti nasazení prostředí.

ArmTemplateParameterProperties

Vlastnosti parametru šablony Azure Resource Manager.

Name Typ Description
name

string

Název parametru šablony.

value

string

Hodnota parametru šablony.

CloudError

Chyba požadavku REST.

Name Typ Description
error

CloudErrorBody

Chyba cloudu, ke které došlo

CloudErrorBody

Text chyby z požadavku REST

Name Typ Description
code

string

Kód chyby

details

CloudErrorBody[]

Vnitřní chyby.

message

string

Chybová zpráva

target

string

Cíl chyby.

DtlEnvironment

Prostředí, což je v podstatě nasazení šablony ARM.

Name Typ 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á prostředí vytvořila.

properties.createdByUser

string

Tvůrce prostředí.

properties.deploymentProperties

EnvironmentDeploymentProperties

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 Typ Description
armTemplateId

string

Identifikátor šablony Azure Resource Manager.

parameters

ArmTemplateParameterProperties[]

Parametry šablony Azure Resource Manager.