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 |
---|---|---|---|---|
lab
|
path | True |
string |
Název testovacího prostředí. |
name
|
path | True |
string |
Název prostředí. |
resource
|
path | True |
string |
Název skupiny prostředků. |
subscription
|
path | True |
string |
ID předplatného. |
user
|
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 |
Vlastnosti nasazení prostředí. |
|
tags |
object |
Značky prostředku. |
Odpovědi
Name | Typ | 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 | Přístup k 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
Name | Description |
---|---|
Arm |
Vlastnosti parametru šablony Azure Resource Manager. |
Cloud |
Chyba požadavku REST. |
Cloud |
Text chyby z požadavku REST |
Dtl |
Prostředí, což je v podstatě nasazení šablony ARM. |
Environment |
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 |
Chyba cloudu, ke které došlo |
CloudErrorBody
Text chyby z požadavku REST
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
details |
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 |
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 |
Parametry šablony Azure Resource Manager. |