Labs - Create Or Update

Layanan:: Dev Test Labs

Versi API:: 2018-09-15

Membuat atau mengganti lab yang ada. Operasi ini bisa memakan waktu cukup lama untuk diselesaikan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
name	path	True	string	Nama lab.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
location	string	Lokasi geografis tempat sumber daya berada
properties.announcement	LabAnnouncementProperties	Properti pengumuman lab apa pun yang terkait dengan lab ini
properties.environmentPermission	EnvironmentPermission	Hak akses yang akan diberikan kepada pengguna saat memprovisikan lingkungan
properties.extendedProperties	object	Properti lab yang diperluas yang digunakan untuk fitur eksperimental
properties.labStorageType	StorageType	Jenis penyimpanan yang digunakan oleh lab. Ini bisa Premium atau Standar. Defaultnya adalah Premium.
properties.mandatoryArtifactsResourceIdsLinux	string[]	Daftar ID sumber daya artefak yang diurutkan yang harus diterapkan pada semua pembuatan VM Linux secara default, sebelum artefak yang ditentukan oleh pengguna.
properties.mandatoryArtifactsResourceIdsWindows	string[]	Daftar ID sumber daya artefak yang diurutkan yang harus diterapkan pada semua pembuatan VM Windows secara default, sebelum artefak yang ditentukan oleh pengguna.
properties.premiumDataDisks	PremiumDataDisk	Pengaturan untuk mengaktifkan penggunaan disk data premium. Ketika nilainya adalah 'Diaktifkan', pembuatan disk data standar atau premium diizinkan. Ketika nilainya adalah 'Dinonaktifkan', hanya pembuatan disk data standar yang diizinkan.
properties.support	LabSupportProperties	Properti pesan dukungan lab apa pun yang terkait dengan lab ini
tags	object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	Lab	Operasi pembaruan 'Lab' sumber daya berhasil
201 Created	Lab	Operasi pembuatan 'Lab' sumber daya berhasil Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

Lab

Operasi pembaruan 'Lab' sumber daya berhasil

201 Created

Lab

Operasi pembuatan 'Lab' sumber daya berhasil

Header

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Labs_CreateOrUpdate

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 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"
  }
}

Kode status:: 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"
  }
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
EnableStatus	Menunjukkan apakah sumber artefak diaktifkan (nilai: Diaktifkan, Dinonaktifkan).
EnvironmentPermission	Hak akses yang akan diberikan kepada pengguna saat memprovisikan lingkungan
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
Lab	Sebuah lab.
LabAnnouncementProperties	Properti spanduk pengumuman lab
LabSupportProperties	Properti spanduk dukungan lab
PremiumDataDisk	Pengaturan untuk mengaktifkan penggunaan disk data premium. Ketika nilainya adalah 'Diaktifkan', pembuatan disk data standar atau premium diizinkan. Ketika nilainya adalah 'Dinonaktifkan', hanya pembuatan disk data standar yang diizinkan.
StorageType	Jenis penyimpanan untuk disk (yaitu Standar, Premium).
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

EnableStatus

Enumerasi

Menunjukkan apakah sumber artefak diaktifkan (nilai: Diaktifkan, Dinonaktifkan).

Nilai	Deskripsi
Enabled
Disabled

EnvironmentPermission

Enumerasi

Hak akses yang akan diberikan kepada pengguna saat memprovisikan lingkungan

Nilai	Deskripsi
Reader
Contributor

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

Lab

Objek

Sebuah lab.

Nama	Jenis	Nilai default	Deskripsi
id	string		ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string		Lokasi geografis tempat sumber daya berada
name	string		Nama sumber daya
properties.announcement	LabAnnouncementProperties		Properti pengumuman lab apa pun yang terkait dengan lab ini
properties.artifactsStorageAccount	string		Akun penyimpanan artefak lab.
properties.createdDate	string (date-time)		Tanggal pembuatan lab.
properties.defaultPremiumStorageAccount	string		Akun penyimpanan premium default lab.
properties.defaultStorageAccount	string		Akun penyimpanan default lab.
properties.environmentPermission	EnvironmentPermission		Hak akses yang akan diberikan kepada pengguna saat memprovisikan lingkungan
properties.extendedProperties	object		Properti lab yang diperluas yang digunakan untuk fitur eksperimental
properties.labStorageType	StorageType	Premium	Jenis penyimpanan yang digunakan oleh lab. Ini bisa Premium atau Standar. Defaultnya adalah Premium.
properties.loadBalancerId	string		Load balancer yang digunakan untuk VM lab yang menggunakan alamat IP bersama.
properties.mandatoryArtifactsResourceIdsLinux	string[]		Daftar ID sumber daya artefak yang diurutkan yang harus diterapkan pada semua pembuatan VM Linux secara default, sebelum artefak yang ditentukan oleh pengguna.
properties.mandatoryArtifactsResourceIdsWindows	string[]		Daftar ID sumber daya artefak yang diurutkan yang harus diterapkan pada semua pembuatan VM Windows secara default, sebelum artefak yang ditentukan oleh pengguna.
properties.networkSecurityGroupId	string		Kelompok Keamanan Jaringan yang dilampirkan ke antarmuka Jaringan VM lab untuk membatasi port terbuka.
properties.premiumDataDiskStorageAccount	string		Akun penyimpanan disk data premium lab.
properties.premiumDataDisks	PremiumDataDisk		Pengaturan untuk mengaktifkan penggunaan disk data premium. Ketika nilainya adalah 'Diaktifkan', pembuatan disk data standar atau premium diizinkan. Ketika nilainya adalah 'Dinonaktifkan', hanya pembuatan disk data standar yang diizinkan.
properties.provisioningState	string		Status provisi sumber daya.
properties.publicIpId	string		Alamat IP publik untuk load balancer lab.
properties.support	LabSupportProperties		Properti pesan dukungan lab apa pun yang terkait dengan lab ini
properties.uniqueIdentifier	string		Pengidentifikasi unik yang tidak dapat diubah dari sumber daya (Guid).
properties.vaultName	string		Brankas kunci lab.
properties.vmCreationResourceGroup	string		Grup sumber daya tempat semua komputer virtual lab baru akan dibuat. Untuk membiarkan DevTest Labs mengelola pembuatan grup sumber daya, atur nilai ini ke null.
systemData	systemData		Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object		Tag sumber daya.
type	string		Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

LabAnnouncementProperties

Objek

Properti spanduk pengumuman lab

Nama	Jenis	Deskripsi
enabled	EnableStatus	Apakah pengumuman lab aktif/diaktifkan saat ini?
expirationDate	string (date-time)	Waktu di mana pengumuman kedaluwarsa (null untuk tidak pernah)
expired	boolean	Apakah pengumuman ini sudah kedaluwarsa?
markdown	string	Teks markdown (jika ada) yang ditampilkan lab ini di UI. Jika dibiarkan kosong/null, tidak ada yang akan ditampilkan.
provisioningState	string	Status provisi sumber daya.
title	string	Judul teks biasa untuk pengumuman lab
uniqueIdentifier	string	Pengidentifikasi unik yang tidak dapat diubah dari sumber daya (Guid).

LabSupportProperties

Objek

Properti spanduk dukungan lab

Nama	Jenis	Deskripsi
enabled	EnableStatus	Apakah banner dukungan lab aktif/diaktifkan saat ini?
markdown	string	Teks markdown (jika ada) yang ditampilkan lab ini di UI. Jika dibiarkan kosong/null, tidak ada yang akan ditampilkan.

PremiumDataDisk

Enumerasi

Pengaturan untuk mengaktifkan penggunaan disk data premium. Ketika nilainya adalah 'Diaktifkan', pembuatan disk data standar atau premium diizinkan. Ketika nilainya adalah 'Dinonaktifkan', hanya pembuatan disk data standar yang diizinkan.

Nilai	Deskripsi
Disabled
Enabled

StorageType

Enumerasi

Jenis penyimpanan untuk disk (yaitu Standar, Premium).

Nilai	Deskripsi
Standard
Premium
StandardSSD

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.