Environments - Create Or Update
Utwórz lub zastąp istniejące środowisko. Wykonanie tej operacji może chwilę potrwać.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/environments/{name}?api-version=2018-09-15
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
lab
|
path | True |
string |
Nazwa laboratorium. |
name
|
path | True |
string |
Nazwa środowiska. |
resource
|
path | True |
string |
Nazwa grupy zasobów. |
subscription
|
path | True |
string |
Identyfikator subskrypcji. |
user
|
path | True |
string |
Nazwa profilu użytkownika. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
location |
string |
Lokalizacja zasobu. |
properties.armTemplateDisplayName |
string |
Nazwa wyświetlana szablonu usługi Azure Resource Manager, który wygenerował środowisko. |
properties.deploymentProperties |
Właściwości wdrożenia środowiska. |
|
tags |
object |
Tagi zasobu. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
201 Created |
Utworzone |
|
Other Status Codes |
BadRequest |
Zabezpieczenia
azure_auth
Przyznawanie niejawne OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | Uzyskiwanie dostępu do platformy Microsoft Azure |
Przykłady
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"
}
}
Definicje
Nazwa | Opis |
---|---|
Arm |
Właściwości parametru szablonu usługi Azure Resource Manager. |
Cloud |
Błąd żądania REST. |
Cloud |
Treść błędu z żądania REST. |
Dtl |
Środowisko, które jest zasadniczo wdrożeniem szablonu usługi ARM. |
Environment |
Właściwości wdrożenia środowiska. |
ArmTemplateParameterProperties
Właściwości parametru szablonu usługi Azure Resource Manager.
Nazwa | Typ | Opis |
---|---|---|
name |
string |
Nazwa parametru szablonu. |
value |
string |
Wartość parametru szablonu. |
CloudError
Błąd żądania REST.
Nazwa | Typ | Opis |
---|---|---|
error |
Błąd chmury, który wystąpił |
CloudErrorBody
Treść błędu z żądania REST.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu. |
details |
Błędy wewnętrzne. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
DtlEnvironment
Środowisko, które jest zasadniczo wdrożeniem szablonu usługi ARM.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
location |
string |
Lokalizacja zasobu. |
name |
string |
Nazwa zasobu. |
properties.armTemplateDisplayName |
string |
Nazwa wyświetlana szablonu usługi Azure Resource Manager, który wygenerował środowisko. |
properties.createdByUser |
string |
Twórca środowiska. |
properties.deploymentProperties |
Właściwości wdrożenia środowiska. |
|
properties.provisioningState |
string |
Stan aprowizacji zasobu. |
properties.resourceGroupId |
string |
Identyfikator grupy zasobów zawierającej zasoby środowiska. |
properties.uniqueIdentifier |
string |
Unikatowy niezmienny identyfikator zasobu (Guid). |
tags |
object |
Tagi zasobu. |
type |
string |
Typ zasobu. |
EnvironmentDeploymentProperties
Właściwości wdrożenia środowiska.
Nazwa | Typ | Opis |
---|---|---|
armTemplateId |
string |
Identyfikator szablonu usługi Azure Resource Manager. |
parameters |
Parametry szablonu usługi Azure Resource Manager. |