Aracılığıyla paylaş


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 İçinde Gerekli Tür 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 Tür Description
location

string

Kaynağın konumu.

properties.armTemplateDisplayName

string

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

properties.deploymentProperties

EnvironmentDeploymentProperties

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

tags

object

Kaynağın etiketleri.

Yanıtlar

Name Tür Description
200 OK

DtlEnvironment

Tamam

201 Created

DtlEnvironment

Oluşturulan

Other Status Codes

CloudError

BadRequest

Güvenlik

azure_auth

OAuth2 Örtük Verme

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation Microsoft Azure'a erişme

Örnekler

Environments_CreateOrUpdate

Örnek isteği

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

Örnek yanıt

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

Name Description
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 Tür Description
name

string

Şablon parametresinin adı.

value

string

Şablon parametresinin değeri.

CloudError

REST isteğinden kaynaklanan hata.

Name Tür Description
error

CloudErrorBody

Oluşan bulut hatası

CloudErrorBody

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

Name Tür Description
code

string

Hata kodu.

details

CloudErrorBody[]

İç hatalar.

message

string

Hata iletisi.

target

string

Hata hedefi.

DtlEnvironment

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

Name Tür 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

EnvironmentDeploymentProperties

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 Tür Description
armTemplateId

string

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

parameters

ArmTemplateParameterProperties[]

Azure Resource Manager şablonunun parametreleri.