Environments - Create Or Update

Membuat atau mengganti lingkungan yang ada. Penyelesaian operasi ini bisa memakan waktu cukup lama.

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

Parameter URI

Name In Required Type Description
labName
path True
  • string

Nama lab.

name
path True
  • string

Nama lingkungan.

resourceGroupName
path True
  • string

Nama grup sumber daya.

subscriptionId
path True
  • string

ID langganan.

userName
path True
  • string

Nama profil pengguna.

api-version
query True
  • string

Versi API klien.

Isi Permintaan

Name Type Description
location
  • string

Lokasi sumber daya.

properties.armTemplateDisplayName
  • string

Nama tampilan templat Azure Resource Manager yang menghasilkan lingkungan.

properties.deploymentProperties

Properti penyebaran lingkungan.

tags
  • object

Tag sumber daya.

Respons

Name Type Description
200 OK

OK

201 Created

Dibuat

Other Status Codes

BadRequest

Keamanan

azure_auth

Pemberian Implisit OAuth2

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

Scopes

Name Description
user_impersonation Akses Microsoft Azure

Contoh

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

Definisi

ArmTemplateParameterProperties

Properti parameter templat Azure Resource Manager.

CloudError

Kesalahan dari permintaan REST.

CloudErrorBody

Isi kesalahan dari permintaan REST.

DtlEnvironment

Lingkungan, yang pada dasarnya merupakan penyebaran templat ARM.

EnvironmentDeploymentProperties

Properti penyebaran lingkungan.

ArmTemplateParameterProperties

Properti parameter templat Azure Resource Manager.

Name Type Description
name
  • string

Nama parameter templat.

value
  • string

Nilai parameter templat.

CloudError

Kesalahan dari permintaan REST.

Name Type Description
error

Kesalahan cloud yang terjadi

CloudErrorBody

Isi kesalahan dari permintaan REST.

Name Type Description
code
  • string

Kode kesalahan.

details

Kesalahan dalam.

message
  • string

Pesan kesalahan.

target
  • string

Target kesalahan.

DtlEnvironment

Lingkungan, yang pada dasarnya merupakan penyebaran templat ARM.

Name Type Description
id
  • string

Pengidentifikasi sumber daya.

location
  • string

Lokasi sumber daya.

name
  • string

Nama sumber daya.

properties.armTemplateDisplayName
  • string

Nama tampilan templat Azure Resource Manager yang menghasilkan lingkungan.

properties.createdByUser
  • string

Pembuat lingkungan.

properties.deploymentProperties

Properti penyebaran lingkungan.

properties.provisioningState
  • string

Status provisi sumber daya.

properties.resourceGroupId
  • string

Pengidentifikasi grup sumber daya yang berisi sumber daya lingkungan.

properties.uniqueIdentifier
  • string

Pengidentifikasi unik yang tidak dapat diubah dari sumber daya (Guid).

tags
  • object

Tag sumber daya.

type
  • string

Jenis sumber daya.

EnvironmentDeploymentProperties

Properti penyebaran lingkungan.

Name Type Description
armTemplateId
  • string

Pengidentifikasi templat Azure Resource Manager.

parameters

Parameter templat Azure Resource Manager.