Environments - Create Or Update

Var olan bir ortamı oluşturun veya değiştirin. Bu işlemin tamamlanması biraz zaman alabilir.

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

URI Parametreleri

Name In Required Type Description
labName
path True
  • string

Laboratuvarın adı.

name
path True
  • string

Ortamın adı.

resourceGroupName
path True
  • string

Kaynak grubunun adı.

subscriptionId
path True
  • string

Abonelik kimliği.

userName
path True
  • string

Kullanıcı profilinin adı.

api-version
query True
  • string

İstemci API sürümü.

İstek Gövdesi

Name Type Description
location
  • string

Kaynağın konumu.

properties.armTemplateDisplayName
  • string

Ortamı oluşturan Azure Resource Manager şablonunun görünen adı.

properties.deploymentProperties

Ortamın dağıtım özellikleri.

tags
  • object

Kaynağın etiketleri.

Yanıtlar

Name Type Description
200 OK

Tamam

201 Created

Oluşturulan

Other Status Codes

BadRequest

Güvenlik

azure_auth

OAuth2 Örtük Verme

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

Scopes

Name Description
user_impersonation Erişim Microsoft Azure

Örnekler

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

Tanımlar

ArmTemplateParameterProperties

Azure Resource Manager şablonu parametresinin özellikleri.

CloudError

REST isteğinden kaynaklanan hata.

CloudErrorBody

REST isteğinden gelen hatanın gövdesi.

DtlEnvironment

Temelde arm şablonu dağıtımı olan bir ortam.

EnvironmentDeploymentProperties

Ortam dağıtımının özellikleri.

ArmTemplateParameterProperties

Azure Resource Manager şablonu parametresinin özellikleri.

Name Type Description
name
  • string

Şablon parametresinin adı.

value
  • string

Şablon parametresinin değeri.

CloudError

REST isteğinden kaynaklanan hata.

Name Type Description
error

Oluşan bulut hatası

CloudErrorBody

REST isteğinden gelen hatanın gövdesi.

Name Type Description
code
  • string

Hata kodu.

details

İç hatalar.

message
  • string

Hata iletisi.

target
  • string

Hata hedefi.

DtlEnvironment

Temelde arm şablonu dağıtımı olan bir ortam.

Name Type Description
id
  • string

Kaynağın tanımlayıcısı.

location
  • string

Kaynağın konumu.

name
  • string

Kaynağın adı.

properties.armTemplateDisplayName
  • string

Ortamı oluşturan Azure Resource Manager şablonunun görünen adı.

properties.createdByUser
  • string

Ortamı oluşturan.

properties.deploymentProperties

Ortamın dağıtım özellikleri.

properties.provisioningState
  • string

Kaynağın sağlama durumu.

properties.resourceGroupId
  • string

Ortamın kaynaklarını içeren kaynak grubunun tanımlayıcısı.

properties.uniqueIdentifier
  • string

Kaynağın benzersiz sabit tanımlayıcısı (Guid).

tags
  • object

Kaynağın etiketleri.

type
  • string

Kaynağın türü.

EnvironmentDeploymentProperties

Ortam dağıtımının özellikleri.

Name Type Description
armTemplateId
  • string

Azure Resource Manager şablonunun tanımlayıcısı.

parameters

Azure Resource Manager şablonunun parametreleri.