Environments - Create Or Update

Hizmet:: Dev Test Labs

API Sürümü:: 2018-09-15

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 minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId	path	True	string minLength: 1	Hedef aboneliğin kimliği.
userName	path	True	string	Kullanıcı profilinin adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
location	string	Kaynağın bulunduğu coğrafi konum
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	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	DtlEnvironment	Kaynak 'DtlEnvironment' güncelleştirme işlemi başarılı oldu
201 Created	DtlEnvironment	Kaynak 'DtlEnvironment' oluşturma işlemi başarılı oldu Üst Bilgiler Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

DtlEnvironment

Kaynak 'DtlEnvironment' güncelleştirme işlemi başarılı oldu

201 Created

DtlEnvironment

Kaynak 'DtlEnvironment' oluşturma işlemi başarılı oldu

Üst Bilgiler

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

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

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Environments_CreateOrUpdate

Örnek isteği

HTTP

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": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}",
      "parameters": []
    }
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "name": "{environmentName}",
  "type": "Microsoft.DevTestLab/labs/users/environments",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/users/{uniqueIdentifier}/environments/{environmentName}",
  "location": "{location}",
  "properties": {
    "createdByUser": "user@contoso.com",
    "deploymentProperties": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    },
    "provisioningState": "Succeeded",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Durum kodu:: 201

{
  "name": "{environmentName}",
  "type": "Microsoft.DevTestLab/labs/users/environments",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/users/{uniqueIdentifier}/environments/{environmentName}",
  "location": "{location}",
  "properties": {
    "createdByUser": "user@contoso.com",
    "deploymentProperties": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    },
    "provisioningState": "Creating",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Tanımlar

Name	Description
ArmTemplateParameterProperties	Azure Resource Manager şablon parametresinin özellikleri.
createdByType	Kaynağı oluşturan kimliğin türü.
DtlEnvironment	Temelde arm şablonu dağıtımı olan bir ortam.
EnvironmentDeploymentProperties	Ortam dağıtımının özellikleri.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

ArmTemplateParameterProperties

Nesne

Azure Resource Manager şablon parametresinin özellikleri.

Name	Tür	Description
name	string	Şablon parametresinin adı.
value	string	Şablon parametresinin değeri.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DtlEnvironment

Nesne

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

Name	Tür	Description
id	string	Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties.armTemplateDisplayName	string	Ortamı oluşturan Azure Resource Manager şablonunun görünen adı.
properties.createdByUser	string	Ortamın oluşturucusu.
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).
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

EnvironmentDeploymentProperties

Nesne

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.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

Aracılığıyla paylaş

Environments - Create Or Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

Environments_CreateOrUpdate

Örnek isteği

Örnek yanıt

Tanımlar

ArmTemplateParameterProperties

createdByType

DtlEnvironment

EnvironmentDeploymentProperties

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

systemData