Environments - Create Or Update
Skapa eller ersätta 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 | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
lab
|
path | True |
string |
Namnet på labbet. |
name
|
path | True |
string |
Namnet på miljön. |
resource
|
path | True |
string |
Namnet på resursgruppen. |
subscription
|
path | True |
string |
Prenumerations-ID: t. |
user
|
path | True |
string |
Namnet på användarprofilen. |
api-version
|
query | True |
string |
Klient-API-version. |
Begärandetext
Name | Typ | 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 |
Taggarna för resursen. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Skapad |
|
Other Status Codes |
BadRequest |
Säkerhet
azure_auth
Implicit beviljande av OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Få åtkomst till 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
Name | Description |
---|---|
Arm |
Egenskaper för en Azure Resource Manager-mallparameter. |
Cloud |
Fel från en REST-begäran. |
Cloud |
Brödtext för ett fel från en REST-begäran. |
Dtl |
En miljö, som i princip är en DISTRIBUTION av ARM-mallar. |
Environment |
Egenskaper för en miljödistribution. |
ArmTemplateParameterProperties
Egenskaper för en Azure Resource Manager-mallparameter.
Name | Typ | Description |
---|---|---|
name |
string |
Namnet på mallparametern. |
value |
string |
Värdet för mallparametern. |
CloudError
Fel från en REST-begäran.
Name | Typ | Description |
---|---|---|
error |
Molnfelet som inträffade |
CloudErrorBody
Brödtext för ett fel från en REST-begäran.
Name | Typ | Description |
---|---|---|
code |
string |
Felkoden. |
details |
Inre fel. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
DtlEnvironment
En miljö, som i princip är en DISTRIBUTION av ARM-mallar.
Name | Typ | 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 |
Taggarna för resursen. |
type |
string |
Resurstypen. |
EnvironmentDeploymentProperties
Egenskaper för en miljödistribution.
Name | Typ | Description |
---|---|---|
armTemplateId |
string |
Azure Resource Manager-mallens identifierare. |
parameters |
Parametrarna för Azure Resource Manager-mallen. |