Поделиться через


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

Имя В Обязательно Тип Описание
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 клиента.

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

Имя Тип Описание
location

string

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

properties.armTemplateDisplayName

string

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

properties.deploymentProperties

EnvironmentDeploymentProperties

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

tags

object

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

Ответы

Имя Тип Описание
200 OK

DtlEnvironment

ОК

201 Created

DtlEnvironment

Создание

Other Status Codes

CloudError

BadRequest

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

azure_auth

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

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation Доступ к Microsoft Azure

Примеры

Environments_CreateOrUpdate

Образец запроса

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

Пример ответа

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

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

CloudError

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

CloudErrorBody

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

DtlEnvironment

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

EnvironmentDeploymentProperties

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

ArmTemplateParameterProperties

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

Имя Тип Описание
name

string

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

value

string

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

CloudError

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

Имя Тип Описание
error

CloudErrorBody

Произошла облачная ошибка

CloudErrorBody

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

Имя Тип Описание
code

string

Код ошибки.

details

CloudErrorBody[]

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

message

string

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

target

string

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

DtlEnvironment

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

Имя Тип Описание
id

string

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

location

string

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

name

string

Имя ресурса.

properties.armTemplateDisplayName

string

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

properties.createdByUser

string

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

properties.deploymentProperties

EnvironmentDeploymentProperties

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

properties.provisioningState

string

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

properties.resourceGroupId

string

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

properties.uniqueIdentifier

string

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

tags

object

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

type

string

Тип ресурса.

EnvironmentDeploymentProperties

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

Имя Тип Описание
armTemplateId

string

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

parameters

ArmTemplateParameterProperties[]

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