Environments - Create Or Update

Создайте или замените существующую среду. Эта операция может занять некоторое время.

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

Параметры URI

Name In Required Type Description
labName
path True
  • string

Имя лаборатории.

name
path True
  • string

Имя среды.

resourceGroupName
path True
  • string

Имя группы ресурсов.

subscriptionId
path True
  • string

Идентификатор подписки.

userName
path True
  • string

Имя профиля пользователя.

api-version
query True
  • string

Версия API клиента.

Текст запроса

Name Type Description
location
  • string

Расположение ресурса.

properties.armTemplateDisplayName
  • string

Отображаемое имя шаблона Azure Resource Manager, создающего среду.

properties.deploymentProperties

Свойства развертывания среды.

tags
  • object

Теги ресурса.

Ответы

Name Type Description
200 OK

ОК

201 Created

Создание

Other Status Codes

BadRequest

Безопасность

azure_auth

Неявное предоставление OAuth2

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

Scopes

Name Description
user_impersonation Доступ Microsoft Azure

Примеры

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

Определения

ArmTemplateParameterProperties

Свойства параметра шаблона Resource Manager Azure.

CloudError

Ошибка из запроса REST.

CloudErrorBody

Текст ошибки из запроса REST.

DtlEnvironment

Среда, которая по сути является развертыванием шаблона ARM.

EnvironmentDeploymentProperties

Свойства развертывания среды.

ArmTemplateParameterProperties

Свойства параметра шаблона Resource Manager Azure.

Name Type Description
name
  • string

Имя параметра шаблона.

value
  • string

Значение параметра шаблона.

CloudError

Ошибка из запроса REST.

Name Type Description
error

Ошибка облака, которая произошла

CloudErrorBody

Текст ошибки из запроса REST.

Name Type Description
code
  • string

Код ошибки.

details

Внутренние ошибки.

message
  • string

Сообщение об ошибке.

target
  • string

Целевой объект ошибки.

DtlEnvironment

Среда, которая по сути является развертыванием шаблона ARM.

Name Type Description
id
  • string

Идентификатор ресурса.

location
  • string

Расположение ресурса.

name
  • string

Имя ресурса.

properties.armTemplateDisplayName
  • string

Отображаемое имя шаблона Azure Resource Manager, создающего среду.

properties.createdByUser
  • string

Создатель среды.

properties.deploymentProperties

Свойства развертывания среды.

properties.provisioningState
  • string

Состояние подготовки ресурса.

properties.resourceGroupId
  • string

Идентификатор группы ресурсов, содержащей ресурсы среды.

properties.uniqueIdentifier
  • string

Уникальный неизменяемый идентификатор ресурса (GUID).

tags
  • object

Теги ресурса.

type
  • string

Тип ресурса.

EnvironmentDeploymentProperties

Свойства развертывания среды.

Name Type Description
armTemplateId
  • string

Идентификатор шаблона Resource Manager Azure.

parameters

Параметры шаблона Azure Resource Manager.