次の方法で共有


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

サブスクリプション ID です。

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

OK

201 Created

DtlEnvironment

作成済み

Other Status Codes

CloudError

BadRequest

セキュリティ

azure_auth

OAuth2 暗黙的な許可

型: oauth2
フロー: implicit
Authorization URL (承認 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

Azure Resource Manager テンプレートの識別子。

parameters

ArmTemplateParameterProperties[]

Azure Resource Manager テンプレートのパラメーター。