Labs - Create Or Update

Hizmet:: Dev Test Labs

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

Var olan bir laboratuvarı 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/{name}?api-version=2018-09-15

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
name	path	True	string	Laboratuvarı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.
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.announcement	LabAnnouncementProperties	Bu laboratuvarla ilişkili laboratuvar duyurularının özellikleri
properties.environmentPermission	EnvironmentPermission	Ortam sağlanırken kullanıcıya verilecek erişim hakları
properties.extendedProperties	object	Deneysel özellikler için kullanılan laboratuvarın genişletilmiş özellikleri
properties.labStorageType	StorageType	Laboratuvar tarafından kullanılan depolama türü. Premium veya Standart olabilir. Varsayılan değer Premium'dur.
properties.mandatoryArtifactsResourceIdsLinux	string[]	Kullanıcı tarafından belirtilen yapıtlardan önce varsayılan olarak tüm Linux VM oluşturma işlemlerine uygulanması gereken yapıt kaynak kimliklerinin sıralı listesi.
properties.mandatoryArtifactsResourceIdsWindows	string[]	Kullanıcı tarafından belirtilen yapıtlardan önce varsayılan olarak tüm Windows VM oluşturma işlemlerine uygulanması gereken yapıt kaynak kimliklerinin sıralı listesi.
properties.premiumDataDisks	PremiumDataDisk	Premium veri disklerinin kullanımını etkinleştirme ayarı. Değeri 'Etkin' olduğunda standart veya premium veri disklerinin oluşturulmasına izin verilir. Değeri 'Devre Dışı' olduğunda, yalnızca standart veri disklerinin oluşturulmasına izin verilir.
properties.support	LabSupportProperties	Bu laboratuvarla ilişkili laboratuvar destek iletisinin özellikleri
tags	object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	Lab	Kaynak 'Lab' güncelleştirme işlemi başarılı oldu
201 Created	Lab	Kaynak 'Lab' 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

Lab

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

201 Created

Lab

Kaynak 'Lab' 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

Labs_CreateOrUpdate

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

{
  "location": "{location}",
  "properties": {
    "labStorageType": "{Standard|Premium}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}


import com.azure.resourcemanager.devtestlabs.models.StorageType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Labs CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2018-09-15/Labs_CreateOrUpdate.json
     */
    /**
     * Sample code: Labs_CreateOrUpdate.
     * 
     * @param manager Entry point to DevTestLabsManager.
     */
    public static void labsCreateOrUpdate(com.azure.resourcemanager.devtestlabs.DevTestLabsManager manager) {
        manager.labs().define("{labName}").withExistingResourceGroup("resourceGroupName").withRegion("{location}")
            .withTags(mapOf("tagName1", "tagValue1")).withLabStorageType(StorageType.fromString("{Standard|Premium}"))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:: 200

{
  "name": "{labName}",
  "type": "Microsoft.DevTestLab/labs",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
  "location": "{location}",
  "properties": {
    "announcement": {
      "enabled": "Disabled",
      "expired": false,
      "markdown": "",
      "title": ""
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "environmentPermission": "Reader",
    "labStorageType": "Standard",
    "mandatoryArtifactsResourceIdsLinux": [],
    "mandatoryArtifactsResourceIdsWindows": [],
    "premiumDataDisks": "Disabled",
    "provisioningState": "Creating",
    "support": {
      "enabled": "Disabled",
      "markdown": ""
    },
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Durum kodu:: 201

{
  "name": "{labName}",
  "type": "Microsoft.DevTestLab/labs",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
  "location": "{location}",
  "properties": {
    "announcement": {
      "enabled": "Disabled",
      "expired": false,
      "markdown": "",
      "title": ""
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "environmentPermission": "Reader",
    "labStorageType": "Standard",
    "mandatoryArtifactsResourceIdsLinux": [],
    "mandatoryArtifactsResourceIdsWindows": [],
    "premiumDataDisks": "Disabled",
    "provisioningState": "Creating",
    "support": {
      "enabled": "Disabled",
      "markdown": ""
    },
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
EnableStatus	Yapıt kaynağının etkin olup olmadığını gösterir (değerler: Etkin, Devre Dışı).
EnvironmentPermission	Ortam sağlanırken kullanıcıya verilecek erişim hakları
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
Lab	Bir laboratuvar.
LabAnnouncementProperties	Laboratuvarın duyuru başlığının özellikleri
LabSupportProperties	Laboratuvarın destek başlığının özellikleri
PremiumDataDisk	Premium veri disklerinin kullanımını etkinleştirme ayarı. Değeri 'Etkin' olduğunda standart veya premium veri disklerinin oluşturulmasına izin verilir. Değeri 'Devre Dışı' olduğunda, yalnızca standart veri disklerinin oluşturulmasına izin verilir.
StorageType	Diskin depolama türü (standart, Premium gibi).
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

createdByType

Numaralandırma

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

Değer	Description
User
Application
ManagedIdentity
Key

EnableStatus

Numaralandırma

Yapıt kaynağının etkin olup olmadığını gösterir (değerler: Etkin, Devre Dışı).

Değer	Description
Enabled
Disabled

EnvironmentPermission

Numaralandırma

Ortam sağlanırken kullanıcıya verilecek erişim hakları

Değer	Description
Reader
Contributor

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.

Lab

Nesne

Bir laboratuvar.

Name	Tür	Default value	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.announcement	LabAnnouncementProperties		Bu laboratuvarla ilişkili laboratuvar duyurularının özellikleri
properties.artifactsStorageAccount	string		Laboratuvarın yapıt depolama hesabı.
properties.createdDate	string (date-time)		Laboratuvarın oluşturulma tarihi.
properties.defaultPremiumStorageAccount	string		Laboratuvarın varsayılan premium depolama hesabı.
properties.defaultStorageAccount	string		Laboratuvarın varsayılan depolama hesabı.
properties.environmentPermission	EnvironmentPermission		Ortam sağlanırken kullanıcıya verilecek erişim hakları
properties.extendedProperties	object		Deneysel özellikler için kullanılan laboratuvarın genişletilmiş özellikleri
properties.labStorageType	StorageType	Premium	Laboratuvar tarafından kullanılan depolama türü. Premium veya Standart olabilir. Varsayılan değer Premium'dur.
properties.loadBalancerId	string		Paylaşılan IP adresi kullanan laboratuvar VM'leri için kullanılan yük dengeleyici.
properties.mandatoryArtifactsResourceIdsLinux	string[]		Kullanıcı tarafından belirtilen yapıtlardan önce varsayılan olarak tüm Linux VM oluşturma işlemlerine uygulanması gereken yapıt kaynak kimliklerinin sıralı listesi.
properties.mandatoryArtifactsResourceIdsWindows	string[]		Kullanıcı tarafından belirtilen yapıtlardan önce varsayılan olarak tüm Windows VM oluşturma işlemlerine uygulanması gereken yapıt kaynak kimliklerinin sıralı listesi.
properties.networkSecurityGroupId	string		Açık bağlantı noktalarını kısıtlamak için laboratuvar VM'lerine bağlı Ağ Güvenlik Grubu Ağ arabirimleri.
properties.premiumDataDiskStorageAccount	string		Laboratuvarın premium veri diski depolama hesabı.
properties.premiumDataDisks	PremiumDataDisk		Premium veri disklerinin kullanımını etkinleştirme ayarı. Değeri 'Etkin' olduğunda standart veya premium veri disklerinin oluşturulmasına izin verilir. Değeri 'Devre Dışı' olduğunda, yalnızca standart veri disklerinin oluşturulmasına izin verilir.
properties.provisioningState	string		Kaynağın sağlama durumu.
properties.publicIpId	string		Laboratuvarın yük dengeleyicisinin genel IP adresi.
properties.support	LabSupportProperties		Bu laboratuvarla ilişkili laboratuvar destek iletisinin özellikleri
properties.uniqueIdentifier	string		Kaynağın benzersiz sabit tanımlayıcısı (Guid).
properties.vaultName	string		Laboratuvarın Anahtar Kasası.
properties.vmCreationResourceGroup	string		Tüm yeni laboratuvar sanal makinelerinin oluşturulacağı kaynak grubu. DevTest Labs'in kaynak grubu oluşturmayı yönetmesine izin vermek için bu değeri null olarak ayarlayın.
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"

LabAnnouncementProperties

Nesne

Laboratuvarın duyuru başlığının özellikleri

Name	Tür	Description
enabled	EnableStatus	Laboratuvar duyurusu şu anda etkin/etkin mi?
expirationDate	string (date-time)	Duyurunun sona erdiği saat (hiçbir zaman için null)
expired	boolean	Bu duyurunun süresi doldu mu?
markdown	string	Bu laboratuvarın kullanıcı arabiriminde görüntülediği markdown metni (varsa). Boş/null bırakılırsa hiçbir şey gösterilmez.
provisioningState	string	Kaynağın sağlama durumu.
title	string	Laboratuvar duyurusunun düz metin başlığı
uniqueIdentifier	string	Kaynağın benzersiz sabit tanımlayıcısı (Guid).

LabSupportProperties

Nesne

Laboratuvarın destek başlığının özellikleri

Name	Tür	Description
enabled	EnableStatus	Laboratuvar destek başlığı şu anda etkin/etkin mi?
markdown	string	Bu laboratuvarın kullanıcı arabiriminde görüntülediği markdown metni (varsa). Boş/null bırakılırsa hiçbir şey gösterilmez.

PremiumDataDisk

Numaralandırma

Premium veri disklerinin kullanımını etkinleştirme ayarı. Değeri 'Etkin' olduğunda standart veya premium veri disklerinin oluşturulmasına izin verilir. Değeri 'Devre Dışı' olduğunda, yalnızca standart veri disklerinin oluşturulmasına izin verilir.

Değer	Description
Disabled
Enabled

StorageType

Numaralandırma

Diskin depolama türü (standart, Premium gibi).

Değer	Description
Standard
Premium
StandardSSD

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ü.