Mengonfigurasi identitas terkelola untuk sumber daya Azure pada sekumpulan mesin virtual

Identitas terkelola untuk sumber daya Azure menyediakan layanan Azure dengan identitas terkelola secara otomatis di Microsoft Entra ID. Anda dapat menggunakan identitas ini untuk mengautentikasi ke layanan apa pun yang mendukung autentikasi Microsoft Entra, tanpa memiliki kredensial dalam kode Anda.

Untuk informasi tentang definisi dan detail Azure Policy, lihat Gunakan Azure Policy untuk menetapkan identitas terkelola (pratinjau).

Dalam artikel ini, menggunakan portal Azure, Anda mempelajari cara melakukan operasi identitas terkelola untuk sumber daya Azure pada set skala mesin virtual.

• Jika Anda tidak terbiasa dengan identitas terkelola untuk sumber daya Azure, lihat bagian overview.

• Jika Anda belum memiliki akun Azure, mendaftar untuk akun yang gratis sebelum Anda melanjutkan.

• Untuk melakukan operasi manajemen dalam artikel ini, akun Anda memerlukan penetapan peran Azure berikut:

  Catatan

  Tidak diperlukan penetapan peran direktori Microsoft Entra tambahan.

  • Kontributor Komputer Virtual untuk mengaktifkan dan menghapus identitas terkelola yang ditetapkan sistem dari kumpulan skala komputer virtual.

Identitas terkelola yang ditetapkan sistem

Di bagian ini, Anda akan mempelajari cara mengaktifkan dan menonaktifkan identitas terkelola yang ditetapkan sistem menggunakan portal Azure.

Aktifkan identitas terkelola yang ditetapkan sistem selama pembuatan kumpulan skala komputer virtual

Saat ini, portal Azure tidak mendukung pengaktifan identitas terkelola yang ditetapkan sistem selama pembuatan set skala komputer virtual. Pertama-tama buat Virtual Machine Scale Set, lalu aktifkan identitas terkelola yang ditetapkan sistem pada set skala:

• Buat Set Penskalaan Mesin Virtual di portal Azure

Aktifkan identitas terkelola yang ditetapkan sistem pada kumpulan skala komputer virtual yang ada

Untuk mengaktifkan identitas terkelola yang ditetapkan sistem pada kumpulan skala komputer virtual yang awalnya disediakan tanpa ini:

1. Masuk ke portal Azure menggunakan akun yang terkait dengan langganan Azure yang berisi set skala komputer virtual.

2. Arahkan ke set skala komputer virtual yang diinginkan.

3. Di bawah Sistem ditetapkan, Status, pilih Aktif lalu klik Simpan:

   

Hapus identitas terkelola yang ditetapkan oleh sistem dari sekumpulan skala mesin virtual

Jika Anda memiliki set skala komputer virtual yang tidak lagi memerlukan identitas terkelola yang ditetapkan sistem:

1. Masuk ke portal Azure menggunakan akun yang terkait dengan langganan Azure yang berisi set skala komputer virtual. Pastikan juga akun Anda memiliki peran yang memberikan Anda izin menulis pada set skala mesin virtual.

2. Arahkan ke set skala komputer virtual yang diinginkan.

3. Di bawah Sistem ditetapkan, Status, pilih Nonaktif, lalu klik Simpan:

   

Identitas terkelola yang ditetapkan pengguna

Di bagian ini, Anda mempelajari cara menambahkan dan menghapus identitas terkelola yang ditetapkan pengguna dari set skala komputer virtual menggunakan portal Azure.

Menetapkan identitas terkelola yang ditetapkan pengguna selama pembuatan set skala mesin virtual

Saat ini, portal Azure tidak mendukung penetapan identitas terkelola yang ditetapkan pengguna selama pembuatan sekumpulan skala mesin virtual. Pertama-tama buat Set Skala Mesin Virtual, lalu tetapkan identitas terkelola yang ditetapkan pengguna ke set skala tersebut.

Menetapkan identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual yang ada

1. Masuk ke portal Azure menggunakan akun yang terkait dengan langganan Azure yang berisi set skala komputer virtual.

2. Buka set skala komputer virtual yang diinginkan dan klik Keamanan>Identitas, Pengguna yang ditetapkan lalu +Tambahkan.

3. Pilih identitas terkelola yang ditetapkan pengguna yang telah dibuat sebelumnya dari daftar.

   

Menghapus identitas terkelola yang ditetapkan pengguna dari kumpulan skala komputer virtual

Masuk ke portal Azure menggunakan akun yang terkait dengan langganan Azure yang berisi VM.

Navigasikan ke kumpulan skala komputer virtual yang diinginkan dan klik Identitas, User ditetapkan, nama identitas terkelola yang ditetapkan pengguna yang ingin Anda hapus, lalu klik Hapus (klik Ya di panel konfirmasi).

Langkah berikutnya

• Menggunakan portal Azure, berikan identitas terkelola set skala mesin virtual Azure akses ke sumber daya Azure lain.

Dalam artikel ini, Anda akan belajar cara melakukan operasi identitas terkelola untuk sumber daya Azure pada set skala mesin virtual Azure, menggunakan Azure CLI.

• Mengaktifkan dan menonaktifkan identitas terkelola yang ditetapkan sistem pada set skala komputer virtual Azure
• Menambahkan dan menghapus identitas terkelola yang ditetapkan pengguna pada set skala komputer virtual Azure

Jika Anda belum memiliki akun Azure, daftar untuk akun gratis sebelum melanjutkan.

Prasyarat

• Jika Anda tidak terbiasa dengan identitas terkelola untuk sumber daya Azure, lihat Apa identitas terkelola untuk sumber daya Azure?. Untuk mempelajari jenis identitas terkelola yang ditetapkan sistem dan yang ditetapkan pengguna, lihat Jenis identitas terkelola.

• Untuk melakukan operasi manajemen dalam artikel ini, akun Anda memerlukan Azure penetapan kontrol akses berbasis peran berikut:

  • Kontributor Komputer Virtual untuk membuat kumpulan skala komputer virtual dan mengaktifkan serta menghapus identitas terkelola yang ditetapkan sistem dan/atau pengguna dari kumpulan skala komputer virtual.

  • Peran Kontributor Identitas Terkelola untuk membuat identitas terkelola yang ditetapkan pengguna.

  • Peran Operator Identitas Terkelola untuk menetapkan dan menghapus identitas terkelola yang ditetapkan pengguna dari dan ke kumpulan skala komputer virtual.

  Catatan

  Tidak diperlukan penugasan peran direktori Microsoft Entra tambahan.

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai dengan Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, install Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi selengkapnya, lihat Cara menjalankan Azure CLI dalam kontainer Docker.

  • Jika Anda menggunakan penginstalan lokal, masuk ke Azure CLI dengan menggunakan perintah az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Authenticate untuk Azure menggunakan Azure CLI.

  • Saat diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Gunakan dan kelola ekstensi dengan Azure CLI.

  • Jalankan az version untuk menemukan versi dan pustaka dependen yang terinstal. Untuk meng-upgrade ke versi terbaru, jalankan az upgrade.

Identitas terkelola yang ditetapkan sistem

Di bagian ini, Anda mempelajari cara mengaktifkan dan menonaktifkan identitas terkelola yang ditetapkan sistem untuk set skala komputer virtual Azure menggunakan Azure CLI.

Mengaktifkan identitas terkelola yang ditetapkan sistem selama pembuatan set skala komputer virtual Azure

Untuk membuat kumpulan skala mesin virtual dengan identitas terkelola yang ditetapkan oleh sistem yang telah diaktifkan:

1. Buat grup sumber daya untuk penahanan dan penyebaran kumpulan skala komputer virtual Anda dan sumber daya terkaitnya, menggunakan az group create. Anda dapat melewati langkah ini jika sudah memiliki grup sumber daya yang ingin Anda gunakan sebagai gantinya:

   az group create --name myResourceGroup --location westus
   

2. Buat kumpulan skala komputer virtual. Contoh berikut membuat set skala mesin virtual bernama myVMSS dengan identitas terkelola yang ditetapkan sistem, seperti yang diminta oleh parameter --assign-identity, dengan --role dan --scope yang ditentukan. Parameter --admin-username dan --admin-password menentukan nama pengguna administratif dan akun kata sandi untuk masuk komputer virtual. Perbarui nilai ini sebagaimana mestinya untuk lingkungan Anda:

   az vmss create --resource-group myResourceGroup --name myVMSS --image win2016datacenter --upgrade-policy-mode automatic --custom-data cloud-init.txt --admin-username azureuser --admin-password myPassword12 --assign-identity --generate-ssh-keys --role contributor --scope mySubscription
   

Mengaktifkan identitas terkelola yang ditetapkan sistem pada kumpulan skala mesin virtual Azure yang ada

Jika Anda perlu Mengaktifkan identitas terkelola yang ditetapkan sistem pada skala mesin virtual Azure yang ada:

az vmss identity assign -g myResourceGroup -n myVMSS

Menonaktifkan identitas terkelola yang ditetapkan sistem dari set skala mesin virtual Azure

Jika Anda memiliki kumpulan skala komputer virtual yang tidak lagi memerlukan identitas terkelola yang ditetapkan sistem, tetapi masih memerlukan identitas terkelola yang ditetapkan pengguna, gunakan perintah berikut:

az vmss update -n myVM -g myResourceGroup --set identity.type='UserAssigned' 

Jika Anda memiliki komputer virtual yang tidak lagi memerlukan identitas terkelola yang ditetapkan sistem dan tidak memiliki identitas terkelola yang ditetapkan pengguna, gunakan perintah berikut:

Catatan

Nilai none sensitif terhadap huruf besar/kecil. Harus huruf kecil.

az vmss update -n myVM -g myResourceGroup --set identity.type="none"

Identitas terkelola yang ditetapkan pengguna

Di bagian ini, Anda mempelajari cara mengaktifkan dan menghapus identitas terkelola yang ditetapkan pengguna menggunakan Azure CLI.

Menetapkan identitas terkelola yang ditetapkan pengguna selama pembuatan set skala mesin virtual

Bagian ini memandu Anda melalui pembuatan kumpulan skala komputer virtual dan penugasan identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual. Jika sudah memiliki kumpulan skala komputer virtual yang ingin Anda gunakan, lewati bagian ini dan lanjutkan ke bagian berikutnya.

1. Anda dapat melewati langkah ini jika sudah memiliki grup sumber daya yang ingin Anda gunakan. Buat grup sumber daya untuk pengelolaan dan penyebaran identitas terkelola yang ditetapkan pengguna Anda, dengan menggunakan az group create. Pastikan untuk mengganti nilai parameter <RESOURCE GROUP> dan <LOCATION> dengan nilai Anda sendiri. :

   az group create --name <RESOURCE GROUP> --location <LOCATION>
   

2. Buat identitas terkelola yang ditetapkan pengguna menggunakan az identity create. Parameter -g menentukan grup sumber daya tempat identitas terkelola yang ditetapkan pengguna dibuat, dan parameter -n menentukan namanya. Pastikan untuk mengganti nilai parameter <RESOURCE GROUP> dan <USER ASSIGNED IDENTITY NAME> dengan nilai Anda sendiri:

   Penting

   Saat Anda membuat identitas terkelola yang ditetapkan pengguna, nama harus dimulai dengan huruf atau angka, dan dapat menyertakan kombinasi karakter alfanumerik, tanda hubung (-) dan garis bawah (_). Untuk penugasan ke komputer virtual atau skala komputer virtual yang diatur agar berfungsi dengan baik, namanya dibatasi hingga 24 karakter. Untuk informasi selengkapnya, lihat Tanya Jawab Umum dan masalah yang sering ditanyakan.

   az identity create -g <RESOURCE GROUP> -n <USER ASSIGNED IDENTITY NAME>
   

   Respons berisi detail identitas terkelola yang telah dibuat dan ditetapkan untuk pengguna, serupa dengan berikut ini. Nilai sumber daya id yang ditetapkan untuk identitas terkelola yang ditugaskan kepada pengguna digunakan dalam langkah berikutnya.

   {
        "clientId": "00001111-aaaa-2222-bbbb-3333cccc4444",
        "clientSecretUrl": "https://control-westcentralus.identity.azure.net/subscriptions/<SUBSCRIPTON ID>/resourcegroups/<RESOURCE GROUP>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<USER ASSIGNED IDENTITY NAME>/credentials?tid=5678&oid=9012&aid=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "id": "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/<RESOURCE GROUP>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<USER ASSIGNED IDENTITY NAME>",
        "location": "westcentralus",
        "name": "<USER ASSIGNED IDENTITY NAME>",
        "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
        "resourceGroup": "<RESOURCE GROUP>",
        "tags": {},
        "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "type": "Microsoft.ManagedIdentity/userAssignedIdentities"    
   }
   

3. Buat kumpulan skala komputer virtual. Contoh berikut membuat set skala mesin virtual yang terkait dengan identitas terkelola yang ditetapkan pengguna baru, seperti yang ditentukan oleh parameter --assign-identity, dengan --role dan --scope yang ditentukan. Pastikan untuk mengganti nilai parameter <RESOURCE GROUP>, <VMSS NAME>, <USER NAME>, <PASSWORD>, <USER ASSIGNED IDENTITY>, <ROLE>, dan <SUBSCRIPTION> dengan nilai Anda sendiri.

   az vmss create --resource-group <RESOURCE GROUP> --name <VMSS NAME> --image <SKU Linux Image> --admin-username <USER NAME> --admin-password <PASSWORD> --assign-identity <USER ASSIGNED IDENTITY> --role <ROLE> --scope <SUBSCRIPTION>
   

Menetapkan identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual yang ada

1. Buat identitas terkelola yang ditetapkan pengguna menggunakan az identity create. Parameter -g menentukan grup sumber daya tempat identitas terkelola yang ditetapkan pengguna dibuat, dan parameter -n menentukan namanya. Pastikan untuk mengganti nilai parameter <RESOURCE GROUP> dan <USER ASSIGNED IDENTITY NAME> dengan nilai Anda sendiri:

   az identity create -g <RESOURCE GROUP> -n <USER ASSIGNED IDENTITY NAME>
   

   Respons berisi detail identitas terkelola yang telah dibuat dan ditetapkan untuk pengguna, serupa dengan berikut ini.

   {
        "clientId": "00001111-aaaa-2222-bbbb-3333cccc4444",
        "clientSecretUrl": "https://control-westcentralus.identity.azure.net/subscriptions/<SUBSCRIPTON ID>/resourcegroups/<RESOURCE GROUP>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<USER ASSIGNED IDENTITY >/credentials?tid=5678&oid=9012&aid=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "id": "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/<RESOURCE GROUP>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<USER ASSIGNED IDENTITY>",
        "location": "westcentralus",
        "name": "<USER ASSIGNED IDENTITY>",
        "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
        "resourceGroup": "<RESOURCE GROUP>",
        "tags": {},
        "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "type": "Microsoft.ManagedIdentity/userAssignedIdentities"    
   }
   

2. Tetapkan identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual yang ada. Pastikan untuk mengganti nilai parameter <RESOURCE GROUP> dan <VIRTUAL MACHINE SCALE SET NAME> dengan nilai Anda sendiri. <USER ASSIGNED IDENTITY> adalah properti name sumber daya identitas yang ditetapkan pengguna, seperti yang dibuat di langkah sebelumnya:

   az vmss identity assign -g <RESOURCE GROUP> -n <VIRTUAL MACHINE SCALE SET NAME> --identities <USER ASSIGNED IDENTITY>
   

Menghapus identitas terkelola yang ditetapkan pengguna dari set skala mesin virtual Azure

Untuk menghapus identitas terkelola yang ditetapkan pengguna dari kumpulan skala komputer virtual menggunakan az vmss identity remove. Jika ini adalah satu-satunya identitas terkelola yang ditetapkan pengguna ke instans skala mesin virtual, UserAssigned dihapus dari nilai jenis identitas. Pastikan untuk mengganti nilai parameter <RESOURCE GROUP> dan <VIRTUAL MACHINE SCALE SET NAME> dengan nilai Anda sendiri. <USER ASSIGNED IDENTITY> adalah properti identitas name terkelola yang ditetapkan pengguna, yang dapat ditemukan di bagian identitas set skala komputer virtual menggunakan az vmss identity show:

az vmss identity remove -g <RESOURCE GROUP> -n <VIRTUAL MACHINE SCALE SET NAME> --identities <USER ASSIGNED IDENTITY>

Jika set skala mesin virtual Anda tidak memiliki identitas terkelola yang ditetapkan sistem dan Anda ingin menghapus semua identitas terkelola yang ditetapkan pengguna dari mesin virtual, gunakan perintah berikut:

Catatan

Nilai none sensitif terhadap huruf besar/kecil. Harus huruf kecil.

az vmss update -n myVMSS -g myResourceGroup --set identity.type="none" identity.userAssignedIdentities=null

Jika kumpulan skala komputer virtual Anda memiliki identitas terkelola yang ditetapkan sistem dan ditetapkan pengguna, Anda dapat menghapus semua identitas yang ditetapkan pengguna dengan beralih untuk hanya menggunakan identitas terkelola yang ditetapkan sistem. Gunakan perintah berikut:

az vmss update -n myVMSS -g myResourceGroup --set identity.type='SystemAssigned' identity.userAssignedIdentities=null 

Langkah berikutnya

• Gambaran Umum Identitas Terkelola untuk Sumber Daya Azure
• Untuk panduan memulai cepat pembuatan set skala mesin virtual Azure, lihat Buat Set Skala Mesin Virtual dengan CLI

Dalam artikel ini, Anda akan belajar cara menggunakan PowerShell untuk melakukan operasi identitas terkelola untuk sumber daya Azure pada skala kumpulan mesin virtual.

• Aktifkan dan nonaktifkan identitas terkelola yang ditetapkan sistem pada kumpulan skala mesin virtual
• Menambah dan menghapus identitas terkelola yang ditetapkan pengguna di kumpulan skala komputer virtual

Catatan

Kami menyarankan agar Anda menggunakan modul Az PowerShell Azure untuk berinteraksi dengan Azure. Lihat Install Azure PowerShell untuk memulai. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Migrasikan Azure PowerShell dari AzureRM ke Az.

Prasyarat

• Jika Anda tidak terbiasa dengan identitas terkelola untuk sumber daya Azure, lihat bagian overview. Pastikan untuk meninjau perbedaan antara identitas yang ditetapkan oleh sistem dan identitas yang dikelola pengguna.

• Jika Anda belum memiliki akun Azure, daftar untuk akun gratis sebelum melanjutkan.

• Untuk melakukan operasi manajemen dalam artikel ini, akun Anda memerlukan Azure penetapan kontrol akses berbasis peran berikut:

  Catatan

  Tidak diperlukan penetapan peran direktori Microsoft Entra tambahan.

  • Kontributor Komputer Virtual untuk membuat kumpulan skala komputer virtual dan mengaktifkan serta menghapus identitas terkelola yang ditetapkan sistem dan/atau yang ditetapkan pengguna dari kumpulan skala komputer virtual.
  • Peran Kontributor Identitas Terkelola untuk membuat identitas terkelola yang ditetapkan pengguna.
  • Peran Operator Identitas Terkelola untuk menetapkan dan menghapus identitas terkelola yang ditetapkan pengguna dari dan ke kumpulan skala komputer virtual.

• Untuk menjalankan contoh skrip, Anda memiliki dua opsi:

  • Gunakan Azure Cloud Shell, yang dapat Anda buka menggunakan tombol Try It di sudut kanan atas blok kode.
  • Jalankan skrip secara lokal dengan menginstal versi terbaru Azure PowerShell, lalu masuk ke Azure menggunakan Connect-AzAccount.

Identitas terkelola yang ditetapkan sistem

Di bagian ini, Anda mempelajari cara mengaktifkan dan menghapus identitas terkelola yang ditetapkan sistem menggunakan Azure PowerShell.

Aktifkan identitas terkelola yang ditetapkan sistem selama pembuatan set skala mesin virtual Azure

Untuk membuat kumpulan skala mesin virtual dengan identitas terkelola yang ditetapkan oleh sistem yang telah diaktifkan:

1. Lihat Contoh 1 di artikel referensi cmdlet New-AzVmssConfig untuk membuat kumpulan skala komputer virtual dengan identitas terkelola yang ditetapkan sistem. Tambahkan parameter -IdentityType SystemAssigned ke cmdlet New-AzVmssConfig:

   $VMSS = New-AzVmssConfig -Location $Loc -SkuCapacity 2 -SkuName "Standard_A0" -UpgradePolicyMode "Automatic" -NetworkInterfaceConfiguration $NetCfg -IdentityType SystemAssigned`
   

Mengaktifkan identitas terkelola yang ditetapkan sistem pada set skala mesin virtual Azure yang sudah ada

Jika Anda perlu mengaktifkan identitas terkelola yang ditetapkan sistem pada set skala komputer virtual Azure yang ada:

1. Pastikan akun Azure yang Anda gunakan milik peran yang memberi Anda izin menulis pada set skala komputer virtual, seperti "Kontributor Komputer Virtual".

2. Ambil properti kumpulan skala komputer virtual menggunakan cmdlet Get-AzVmss. Selanjutnya untuk mengaktifkan identitas terkelola yang ditetapkan sistem, gunakan tombol -IdentityType pada cmdlet Update-AzVmss:

   Update-AzVmss -ResourceGroupName myResourceGroup -Name -myVmss -IdentityType "SystemAssigned"
   

Menonaktifkan identitas terkelola yang ditetapkan oleh sistem dari set skala mesin virtual Azure

Jika Anda memiliki kumpulan skala komputer virtual yang tidak lagi memerlukan identitas terkelola yang ditetapkan sistem, tetapi masih memerlukan identitas terkelola yang ditetapkan pengguna, gunakan cmdlet berikut:

1. Pastikan akun Anda memiliki peran yang memberi Anda izin tulis pada kumpulan skala komputer virtual, seperti "Kontributor Komputer Virtual".

2. Jalankan cmdlet berikut:

   Update-AzVmss -ResourceGroupName myResourceGroup -Name myVmss -IdentityType "UserAssigned"
   

3. Jika Anda memiliki kumpulan skala komputer virtual yang tidak lagi memerlukan identitas terkelola yang ditetapkan sistem dan tidak memiliki identitas terkelola yang ditetapkan pengguna, gunakan perintah berikut:

   Update-AzVmss -ResourceGroupName myResourceGroup -Name myVmss -IdentityType None
   

Identitas terkelola yang ditetapkan pengguna

Di bagian ini, Anda mempelajari cara menambahkan dan menghapus identitas terkelola yang ditetapkan pengguna dari set skala komputer virtual menggunakan Azure PowerShell.

Menetapkan identitas terkelola yang ditetapkan pengguna pada saat pembuatan set skala mesin virtual Azure

Membuat kumpulan skala komputer virtual baru dengan identitas terkelola yang ditetapkan pengguna saat ini tidak didukung melalui PowerShell. Lihat bagian berikutnya tentang cara menambahkan identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual yang ada. Periksa kembali untuk melihat pembaruan.

Menetapkan identitas terkelola yang ditetapkan pengguna ke set skala mesin virtual Azure yang ada

Untuk menetapkan identitas terkelola yang ditetapkan pengguna ke set skala komputer virtual Azure yang ada:

1. Pastikan akun Anda memiliki peran yang memberi Anda izin tulis pada kumpulan skala komputer virtual, seperti "Kontributor Komputer Virtual".

2. Ambil properti kumpulan skala komputer virtual menggunakan cmdlet Get-AzVM. Selanjutnya, untuk menetapkan identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual, gunakan tombol -IdentityType dan -IdentityID di cmdlet Update-AzVmss. Ganti <VM NAME>, <SUBSCRIPTION ID>, <RESOURCE GROUP>, <USER ASSIGNED ID1>, USER ASSIGNED ID2 dengan nilai Anda sendiri.

   Penting

   Saat Anda membuat identitas terkelola yang ditetapkan pengguna, nama harus dimulai dengan huruf atau angka, dan dapat menyertakan kombinasi karakter alfanumerik, tanda hubung (-) dan garis bawah (_). Untuk penugasan ke komputer virtual atau skala komputer virtual yang diatur agar berfungsi dengan baik, namanya dibatasi hingga 24 karakter. Untuk informasi selengkapnya, lihat Tanya Jawab Umum dan masalah yang sering ditanyakan.

   Update-AzVmss -ResourceGroupName <RESOURCE GROUP> -Name <VMSS NAME> -IdentityType UserAssigned -IdentityID "<USER ASSIGNED ID1>","<USER ASSIGNED ID2>"
   

Menghapus identitas terkelola yang ditetapkan pengguna dari perangkat skala mesin virtual Azure.

Jika kumpulan skala komputer virtual Anda memiliki beberapa identitas terkelola yang ditetapkan pengguna, Anda dapat menghapus semuanya, kecuali yang terakhir menggunakan perintah berikut. Pastikan untuk mengganti nilai parameter <RESOURCE GROUP> dan <VIRTUAL MACHINE SCALE SET NAME> dengan nilai Anda sendiri. <USER ASSIGNED IDENTITY NAME> adalah properti nama identitas terkelola yang ditetapkan pengguna, yang harus tetap berada di kumpulan skala komputer virtual. Informasi ini dapat ditemukan di bagian identitas dari kumpulan skala komputer virtual menggunakan az vmss show:

Update-AzVmss -ResourceGroupName myResourceGroup -Name myVmss -IdentityType UserAssigned -IdentityID "<USER ASSIGNED IDENTITY NAME>"

Jika set skala mesin virtual Anda tidak memiliki identitas terkelola yang ditetapkan sistem dan Anda ingin menghapus semua identitas terkelola yang ditetapkan pengguna dari mesin virtual, gunakan perintah berikut:

Update-AzVmss -ResourceGroupName myResourceGroup -Name myVmss -IdentityType None

Jika kumpulan skala komputer virtual Anda memiliki identitas terkelola yang ditetapkan sistem dan ditetapkan pengguna, Anda dapat menghapus semua identitas terkelola yang ditetapkan pengguna dengan beralih untuk hanya menggunakan identitas terkelola yang ditetapkan sistem.

Update-AzVmss -ResourceGroupName myResourceGroup -Name myVmss -IdentityType "SystemAssigned"

Langkah berikutnya

• Gambaran umum identitas terkelola untuk sumber daya Azure

• Untuk panduan memulai cepat pembuatan Mesin Virtual Azure yang lengkap, lihat:

  • Buat komputer virtual Windows dengan PowerShell
  • Membuat komputer virtual Linux dengan PowerShell

Dalam artikel ini, Anda akan belajar cara melakukan operasi identitas terkelola untuk sumber daya Azure pada set skala mesin virtual Azure, menggunakan templat penyebaran Azure Resource Manager.

• Mengaktifkan dan menonaktifkan identitas terkelola yang ditetapkan sistem pada set skala komputer virtual Azure
• Menambahkan dan menghapus identitas terkelola yang ditetapkan pengguna pada skala set mesin virtual Azure

Prasyarat

• Jika Anda tidak terbiasa dengan identitas terkelola untuk sumber daya Azure, lihat bagian overview. Pastikan untuk meninjau perbedaan antara identitas terkelola yang ditetapkan sistem dan ditetapkan pengguna.

• Jika Anda belum memiliki akun Azure, daftar untuk akun gratis sebelum melanjutkan.

• Untuk melakukan operasi manajemen dalam artikel ini, akun Anda memerlukan Azure penetapan kontrol akses berbasis peran berikut:

  Catatan

  Penetapan peran tambahan untuk direktori Microsoft Entra tidak diperlukan.

  • Kontributor Komputer Virtual untuk membuat kumpulan skala komputer virtual dan mengaktifkan serta menghapus identitas terkelola yang ditetapkan sistem dan/atau pengguna dari kumpulan skala komputer virtual.
  • Peran Kontributor Identitas Terkelola untuk membuat identitas terkelola yang ditetapkan pengguna.
  • Peran Operator Identitas Terkelola untuk menetapkan dan menghapus identitas terkelola yang ditetapkan pengguna dari dan ke kumpulan skala komputer virtual.

templat Azure Resource Manager

Seperti halnya portal Azure dan pembuatan skrip, templat Azure Resource Manager menyediakan kemampuan untuk menyebarkan sumber daya baru atau yang dimodifikasi yang ditentukan oleh grup sumber daya Azure. Beberapa opsi tersedia untuk pengeditan dan penyebaran templat, baik berbasis lokal maupun portal, termasuk:

• Menggunakan templat kustom dari Azure Marketplace, yang memungkinkan Anda membuat templat dari awal atau menggunakannya sebagai dasar untuk templat umum atau quickstart yang ada.
• Berasal dari grup sumber daya yang ada, dengan mengekspor templat dari penyebaran asli, atau dari status penyebaran saat ini.
• Menggunakan editor JSON lokal (seperti Visual Studio Code), lalu mengunggah dan menyebarkan dengan menggunakan PowerShell atau CLI.
• Menggunakan Visual Studio proyek Grup Sumber Daya Azure untuk membuat dan menyebarkan templat.

Terlepas dari opsi yang Anda pilih, sintaks templat sama selama penyebaran awal dan pemindahan ulang. Mengaktifkan identitas terkelola untuk sumber daya Azure pada VM baru atau yang sudah ada dilakukan dengan cara yang sama. Selain itu, secara default, Azure Resource Manager melakukan pembaruan inkremental pada penggelaran.

Identitas terkelola yang ditetapkan sistem

Di bagian ini, Anda akan mengaktifkan dan menonaktifkan identitas terkelola yang ditetapkan sistem menggunakan templat Azure Resource Manager.

Aktifkan identitas terkelola yang ditetapkan oleh sistem selama pembuatan set skala mesin virtual atau untuk set skala mesin virtual yang sudah ada.

1. Apakah Anda masuk ke Azure secara lokal atau melalui portal Azure, gunakan akun yang terkait dengan langganan Azure yang berisi skala set mesin virtual.

2. Untuk mengaktifkan identitas terkelola yang ditetapkan sistem, muat templat ke editor, temukan Microsoft.Compute/virtualMachinesScaleSetssumber daya yang menarik di dalam bagian sumber daya dan tambahkan identity properti pada tingkat yang sama dengan "type": "Microsoft.Compute/virtualMachinesScaleSets" properti. Gunakan sintaks berikut:

   "identity": {
       "type": "SystemAssigned"
   }
   

3. Setelah selesai, bagian berikut harus ditambahkan ke bagian sumber daya templat Anda dan harus menyerupai contoh yang ditunjukkan di bawah ini:

    "resources": [
        {
            //other resource provider properties...
            "apiVersion": "2018-06-01",
            "type": "Microsoft.Compute/virtualMachineScaleSets",
            "name": "[variables('vmssName')]",
            "location": "[resourceGroup().location]",
            "identity": {
                "type": "SystemAssigned",
            },
           "properties": {
                //other resource provider properties...
                "virtualMachineProfile": {
                    //other virtual machine profile properties...
   
                }
            }
        }
    ]
   

Menonaktifkan identitas terkelola yang ditetapkan sistem dari set skala mesin virtual Azure

Jika Anda memiliki set skala komputer virtual yang tidak lagi memerlukan identitas terkelola yang ditetapkan sistem:

1. Baik Anda masuk ke Azure secara lokal maupun melalui portal Azure, gunakan akun yang terkait dengan langganan Azure yang mengandung kelompok skala mesin virtual.

2. Muat template ke dalam editor dan cari Microsoft.Compute/virtualMachineScaleSets sumber daya yang diinginkan dalam bagian resources. Jika Anda memiliki Komputer Virtual yang hanya memiliki identitas terkelola yang ditetapkan sistem, Anda dapat menonaktifkannya dengan mengubah jenis identitas menjadi None .

   Microsoft.Compute/virtualMachineScaleSets API versi 2018-06-01

   Jika apiVersion Anda adalah 2018-06-01 dan Mesin Virtual Anda memiliki sistem dan identitas terkelola yang ditetapkan pengguna, hapus SystemAssigned dari jenis identitas dan tetap simpan UserAssigned bersama dengan nilai kamus dari userAssignedIdentities.

   Microsoft.Compute/virtualMachineScaleSets API versi 2018-06-01

   Jika apiVersion Anda adalah 2017-12-01 dan kumpulan skala komputer virtual Anda memiliki identitas terkelola sistem dan yang ditetapkan pengguna, hapus SystemAssigned dari tipe identitas dan simpan UserAssigned bersama dengan array identityIds dari identitas terkelola yang ditetapkan pengguna.

   Contoh berikut menunjukkan kepada Anda cara menghapus identitas terkelola yang ditetapkan sistem dari kumpulan skala komputer virtual tanpa identitas terkelola yang ditetapkan pengguna:

   {
       "name": "[variables('vmssName')]",
       "apiVersion": "2018-06-01",
       "location": "[parameters(Location')]",
       "identity": {
           "type": "None"
        }
   
   }
   

Identitas terkelola yang ditetapkan pengguna

Di bagian ini, Anda menetapkan identitas terkelola yang ditetapkan pengguna ke set skala komputer virtual menggunakan templat Azure Resource Manager.

Catatan

Untuk membuat identitas terkelola yang ditetapkan pengguna menggunakan Templat Azure Resource Manager, lihat Buat identitas terkelola yang ditetapkan pengguna.

Tetapkan identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual

1. Di bagian elemen resources, tambahkan entri berikut untuk menetapkan identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual Anda. Pastikan untuk mengganti <USERASSIGNEDIDENTITY> dengan nama identitas terkelola yang ditetapkan pengguna yang Anda buat.

   Microsoft.Compute/virtualMachineScaleSets API versi 2018-06-01

   Jika apiVersion Anda adalah 2018-06-01, identitas terkelola yang ditetapkan pengguna disimpan dalam format kamus userAssignedIdentities dan nilai <USERASSIGNEDIDENTITYNAME> harus disimpan dalam variabel yang ditentukan di bagian variables templat Anda.

   {
       "name": "[variables('vmssName')]",
       "apiVersion": "2018-06-01",
       "location": "[parameters(Location')]",
       "identity": {
           "type": "userAssigned",
           "userAssignedIdentities": {
               "[resourceID('Microsoft.ManagedIdentity/userAssignedIdentities/',variables('<USERASSIGNEDIDENTITYNAME>'))]": {}
           }
       }
   
   }
   

   Microsoft.Compute/virtualMachineScaleSets API versi 2017-12-01

   Jika apiVersion Anda adalah 2017-12-01 atau lebih lama, identitas terkelola yang ditetapkan pengguna disimpan dalam larik identityIds dan nilai <USERASSIGNEDIDENTITYNAME> harus disimpan dalam variabel yang ditentukan di bagian variabel pada template Anda.

   {
       "name": "[variables('vmssName')]",
       "apiVersion": "2017-03-30",
       "location": "[parameters(Location')]",
       "identity": {
           "type": "userAssigned",
           "identityIds": [
               "[resourceID('Microsoft.ManagedIdentity/userAssignedIdentities/',variables('<USERASSIGNEDIDENTITY>'))]"
           ]
       }
   }
   

2. Saat Anda selesai, templat Anda akan terlihat mirip dengan berikut:

   Microsoft.Compute/virtualMachineScaleSets API versi 2018-06-01

   "resources": [
        {
            //other resource provider properties...
            "apiVersion": "2018-06-01",
            "type": "Microsoft.Compute/virtualMachineScaleSets",
            "name": "[variables('vmssName')]",
            "location": "[resourceGroup().location]",
            "identity": {
                "type": "UserAssigned",
                "userAssignedIdentities": {
                    "[resourceID('Microsoft.ManagedIdentity/userAssignedIdentities/',variables('<USERASSIGNEDIDENTITYNAME>'))]": {}
                }
            },
           "properties": {
                //other virtual machine properties...
                "virtualMachineProfile": {
                    //other virtual machine profile properties...
                }
            }
        }
    ]
   

   Microsoft.Compute/virtualMachines API versi 2017-12-01

   "resources": [
        {
            //other resource provider properties...
            "apiVersion": "2017-12-01",
            "type": "Microsoft.Compute/virtualMachineScaleSets",
            "name": "[variables('vmssName')]",
            "location": "[resourceGroup().location]",
            "identity": {
                "type": "UserAssigned",
                "identityIds": [
                    "[resourceID('Microsoft.ManagedIdentity/userAssignedIdentities/',variables('<USERASSIGNEDIDENTITYNAME>'))]"
                ]
            },
           "properties": {
                //other virtual machine properties...
                "virtualMachineProfile": {
                    //other virtual machine profile properties...
                }
            }
        }
    ]
   

Menghapus identitas terkelola yang ditetapkan pengguna dari set skala mesin virtual Azure

Jika Anda memiliki kumpulan skala komputer virtual yang tidak lagi memerlukan identitas terkelola yang ditetapkan pengguna:

1. Baik Anda masuk ke Azure secara lokal maupun melalui portal Azure, gunakan akun yang terkait dengan langganan Azure yang berisi skala set mesin virtual.

2. Muat template ke dalam editor dan cari Microsoft.Compute/virtualMachineScaleSets sumber daya yang diinginkan dalam bagian resources. Jika Anda memiliki kumpulan skala komputer virtual yang hanya memiliki identitas terkelola yang ditetapkan pengguna, Anda dapat menonaktifkannya dengan mengubah jenis identitas menjadi None .

   Contoh berikut menunjukkan kepada Anda cara menghapus semua identitas terkelola yang ditetapkan pengguna dari Komputer Virtual tanpa identitas terkelola yang ditetapkan sistem:

   {
       "name": "[variables('vmssName')]",
       "apiVersion": "2018-06-01",
       "location": "[parameters(Location')]",
       "identity": {
           "type": "None"
        }
   }
   

   Microsoft.Compute/virtualMachineScaleSets API versi 2018-06-01

   Untuk menghapus satu identitas terkelola yang ditetapkan pengguna dari set skala mesin virtual, hapus dari kamus userAssignedIdentities.

   Jika Anda memiliki identitas yang ditetapkan sistem, simpan dalam nilai type di bawah nilai identity.

   Microsoft.Compute/virtualMachineScaleSets API versi 2017-12-01

   Untuk menghapus satu identitas terkelola yang ditetapkan bagi pengguna dari set skala mesin virtual, hapus dari array identityIds.

   Jika Anda memiliki identitas terkelola yang ditetapkan sistem, simpan dalam nilai type di bawah nilai identity.

Langkah berikutnya

• Gambaran umum Identitas yang Dikelola untuk sumber daya Azure.

Dalam artikel ini, dengan menggunakan CURL untuk melakukan panggilan ke titik akhir REST Azure Resource Manager, Anda akan mempelajari cara melakukan operasi identitas terkelola untuk sumber daya Azure pada set skala mesin virtual.

• Mengaktifkan dan menonaktifkan identitas terkelola yang ditetapkan sistem pada set skala komputer virtual Azure
• Menambahkan dan menghapus identitas terkelola yang ditetapkan pengguna pada set skala komputer virtual Azure

Jika Anda belum memiliki akun Azure, daftar untuk akun gratis sebelum melanjutkan.

Prasyarat

• Jika Anda tidak terbiasa dengan identitas terkelola untuk sumber daya Azure, lihat Apa identitas terkelola untuk sumber daya Azure?. Untuk mempelajari jenis identitas terkelola yang ditetapkan sistem dan yang ditetapkan pengguna, lihat Jenis identitas terkelola.

• Untuk melakukan operasi manajemen dalam artikel ini, akun Anda memerlukan penetapan peran Azure berikut:

  • Kontributor Komputer Virtual untuk membuat kumpulan skala komputer virtual dan mengaktifkan serta menghapus identitas terkelola yang ditetapkan sistem dan/atau pengguna dari kumpulan skala komputer virtual.

  • Peran Kontributor Identitas Terkelola untuk membuat identitas terkelola yang ditetapkan pengguna.

  • Peran Operator Identitas Terkelola untuk menetapkan dan menghapus identitas yang ditetapkan pengguna dari dan ke kumpulan skala komputer virtual.

  Catatan

  Tidak diperlukan penugasan peran direktori Microsoft Entra tambahan.

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai dengan Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, install Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi selengkapnya, lihat Cara menjalankan Azure CLI dalam kontainer Docker.

  • Jika Anda menggunakan penginstalan lokal, masuk ke Azure CLI dengan menggunakan perintah az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Authenticate untuk Azure menggunakan Azure CLI.

  • Saat diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Gunakan dan kelola ekstensi dengan Azure CLI.

  • Jalankan az version untuk menemukan versi dan pustaka dependen yang terinstal. Untuk meng-upgrade ke versi terbaru, jalankan az upgrade.

Identitas terkelola yang ditetapkan sistem

Di bagian ini, Anda mempelajari cara mengaktifkan dan menonaktifkan identitas terkelola yang ditetapkan sistem pada set skala komputer virtual menggunakan CURL untuk melakukan panggilan ke titik akhir REST Azure Resource Manager.

Aktifkan identitas terkelola yang ditetapkan sistem selama pembuatan kumpulan skala komputer virtual

Untuk membuat set skala mesin virtual dengan identitas terkelola yang ditetapkan oleh sistem diaktifkan, Anda perlu membuat set skala mesin virtual dan mengambil token akses guna menggunakan CURL untuk memanggil titik akhir Resource Manager dengan jenis identitas terkelola yang ditetapkan oleh sistem.

1. Buat grup sumber daya untuk penahanan dan penyebaran kumpulan skala komputer virtual Anda dan sumber daya terkaitnya, menggunakan az group create. Anda dapat melewati langkah ini jika Anda sudah memiliki grup sumber daya yang ingin Anda gunakan sebagai gantinya:

   az group create --name myResourceGroup --location westus
   

2. Buat antarmuka jaringan untuk kumpulan skala komputer virtual Anda:

    az network nic create -g myResourceGroup --vnet-name myVnet --subnet mySubnet -n myNic
   

3. Ambil token akses Bearer, yang akan Anda gunakan pada langkah berikutnya di header Otorisasi untuk membuat set skala mesin virtual Anda dengan identitas terkelola yang ditetapkan oleh sistem.

   az account get-access-token
   

4. Dengan menggunakan Azure Cloud Shell, buat set skala komputer virtual menggunakan CURL untuk memanggil titik akhir REST Azure Resource Manager. Contoh berikut membuat kumpulan skala komputer virtual bernama myVMSS di myResourceGroup dengan identitas terkelola yang ditetapkan sistem, seperti yang diidentifikasi dalam isi permintaan berdasarkan nilai "identity":{"type":"SystemAssigned"}. Ganti <ACCESS TOKEN> dengan nilai yang Anda terima di langkah sebelumnya ketika Anda meminta token akses Bearer dan nilai <SUBSCRIPTION ID> yang sesuai untuk lingkungan Anda.

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PUT -d '{"sku":{"tier":"Standard","capacity":3,"name":"Standard_D1_v2"},"location":"eastus","identity":{"type":"SystemAssigned"},"properties":{"overprovision":true,"virtualMachineProfile":{"storageProfile":{"imageReference":{"sku":"2016-Datacenter","publisher":"MicrosoftWindowsServer","version":"latest","offer":"WindowsServer"},"osDisk":{"caching":"ReadWrite","managedDisk":{"storageAccountType":"StandardSSD_LRS"},"createOption":"FromImage"}},"osProfile":{"computerNamePrefix":"myVMSS","adminUsername":"azureuser","adminPassword":"myPassword12"},"networkProfile":{"networkInterfaceConfigurations":[{"name":"myVMSS","properties":{"primary":true,"enableIPForwarding":true,"ipConfigurations":[{"name":"myVMSS","properties":{"subnet":{"id":"/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubnet"}}}]}}]}},"upgradePolicy":{"mode":"Manual"}}}' -H "Content-Type: application/json" -H "Authorization: Bearer <ACCESS TOKEN>"
   

   PUT https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "sku":{
          "tier":"Standard",
          "capacity":3,
          "name":"Standard_D1_v2"
       },
       "location":"eastus",
       "identity":{
          "type":"SystemAssigned"
       },
       "properties":{
          "overprovision":true,
          "virtualMachineProfile":{
             "storageProfile":{
                "imageReference":{
                   "sku":"2016-Datacenter",
                   "publisher":"MicrosoftWindowsServer",
                   "version":"latest",
                   "offer":"WindowsServer"
                },
                "osDisk":{
                   "caching":"ReadWrite",
                   "managedDisk":{
                      "storageAccountType":"StandardSSD_LRS"
                   },
                   "createOption":"FromImage"
                }
             },
             "osProfile":{
                "computerNamePrefix":"myVMSS",
                "adminUsername":"azureuser",
                "adminPassword":"myPassword12"
             },
             "networkProfile":{
                "networkInterfaceConfigurations":[
                   {
                      "name":"myVMSS",
                      "properties":{
                         "primary":true,
                         "enableIPForwarding":true,
                         "ipConfigurations":[
                            {
                               "name":"myVMSS",
                               "properties":{
                                  "subnet":{
                                     "id":"/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubnet"
                                  }
                               }
                            }
                         ]
                      }
                   }
                ]
             }
          },
          "upgradePolicy":{
             "mode":"Manual"
          }
       }
    }  
   

Aktifkan identitas terkelola yang ditetapkan sistem pada kumpulan skala komputer virtual yang ada

Untuk mengaktifkan identitas terkelola yang ditetapkan sistem pada set skala komputer virtual yang ada, Anda perlu memperoleh token akses lalu menggunakan CURL untuk memanggil titik akhir REST Resource Manager untuk memperbarui jenis identitas.

1. Ambil token akses Bearer, yang akan Anda gunakan pada langkah berikutnya di header Otorisasi untuk membuat set skala mesin virtual Anda dengan identitas terkelola yang ditetapkan oleh sistem.

   az account get-access-token
   

2. Gunakan perintah CURL berikut untuk memanggil titik akhir REST Azure Resource Manager untuk mengaktifkan identitas terkelola yang ditetapkan sistem pada set skala komputer virtual Anda seperti yang diidentifikasi dalam isi permintaan dengan nilai {"identity":{"type":"SystemAssigned"} untuk set skala komputer virtual bernama myVMSS. Ganti <ACCESS TOKEN> dengan nilai yang Anda terima di langkah sebelumnya ketika Anda meminta token akses Bearer dan nilai <SUBSCRIPTION ID> yang sesuai untuk lingkungan Anda.

   Penting

   Untuk memastikan Anda tidak menghapus identitas terkelola yang ditetapkan pengguna apa pun yang ditetapkan ke kumpulan skala komputer virtual, Anda perlu mencantumkan identitas terkelola yang ditetapkan pengguna menggunakan perintah CURL ini: curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP>/providers/Microsoft.Compute/virtualMachineScaleSets/<VMSS NAME>?api-version=2018-06-01' -H "Authorization: Bearer <ACCESS TOKEN>". Jika Anda memiliki identitas terkelola yang ditetapkan pengguna yang ditetapkan ke kumpulan skala komputer virtual seperti yang diidentifikasi dalam nilai identity dalam respons, lewati ke langkah 3 yang memperlihatkan cara mempertahankan identitas terkelola yang ditetapkan pengguna sambil mengaktifkan identitas terkelola yang ditetapkan sistem pada kumpulan skala komputer virtual Anda.

    curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PATCH -d '{"identity":{"type":"SystemAssigned"}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"SystemAssigned"
       }
    }
   

3. Untuk mengaktifkan identitas terkelola yang ditetapkan sistem pada kumpulan skala komputer virtual dengan identitas terkelola yang ditetapkan pengguna yang ada, Anda perlu menambahkan SystemAssigned ke nilai type.

   Misalnya, jika kumpulan skala mesin virtual Anda memiliki identitas terkelola yang ditetapkan ke pengguna ID1 dan ID2, dan Anda ingin menambahkan identitas terkelola yang ditetapkan sistem ke kumpulan skala mesin virtual, gunakan perintah CURL berikut. Ganti <ACCESS TOKEN> dan <SUBSCRIPTION ID> dengan nilai yang sesuai untuk lingkungan Anda.

   Versi API 2018-06-01 menyimpan identitas terkelola yang ditetapkan pengguna dalam nilai userAssignedIdentities dalam format kamus dibandingkan dengan nilai identityIds dalam format array yang digunakan dalam versi API 2017-12-01.

   API VERSI 2018-06-01

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PATCH -d '{"identity":{"type":"SystemAssigned,UserAssigned", "userAssignedIdentities":{"/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1":{},"/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2":{}}}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"SystemAssigned,UserAssigned",
          "userAssignedIdentities":{
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1":{
             },
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2":{
   
             }
          }
       }
    }
   

   API VERSI 2017-12-01

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01' -X PATCH -d '{"identity":{"type":"SystemAssigned,UserAssigned", "identityIds":["/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1","/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2"]}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"SystemAssigned,UserAssigned",
          "identityIds":[
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1",
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2"
          ]
       }
    }
   

Menonaktifkan identitas terkelola yang ditetapkan sistem dari kumpulan skala komputer virtual

Untuk menonaktifkan identitas yang ditetapkan sistem pada set skala komputer virtual yang ada, Anda perlu memperoleh token akses lalu menggunakan CURL untuk memanggil titik akhir REST Resource Manager untuk memperbarui jenis identitas ke None.

1. Ambil token akses Bearer, yang akan Anda gunakan pada langkah berikutnya di header Otorisasi untuk membuat set skala mesin virtual Anda dengan identitas terkelola yang ditetapkan oleh sistem.

   az account get-access-token
   

2. Perbarui set skala mesin virtual menggunakan CURL untuk memanggil endpoint REST Azure Resource Manager guna menonaktifkan identitas terkelola yang ditetapkan oleh sistem. Contoh berikut menonaktifkan identitas terkelola yang ditetapkan sistem seperti yang diidentifikasi dalam isi permintaan berdasarkan nilai {"identity":{"type":"None"}} dari kumpulan skala komputer virtual bernama myVM. Ganti <ACCESS TOKEN> dengan nilai yang Anda terima di langkah sebelumnya ketika Anda meminta token akses Bearer dan nilai <SUBSCRIPTION ID> yang sesuai untuk lingkungan Anda.

   Penting

   Untuk memastikan Anda tidak menghapus identitas terkelola yang ditetapkan pengguna apa pun yang ditetapkan ke kumpulan skala komputer virtual, Anda perlu mencantumkan identitas terkelola yang ditetapkan pengguna menggunakan perintah CURL ini: curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP>/providers/Microsoft.Compute/virtualMachineScaleSets/<VMSS NAME>?api-version=2018-06-01' -H "Authorization: Bearer <ACCESS TOKEN>". Jika Anda memiliki identitas terkelola yang ditetapkan pengguna yang ditetapkan ke kumpulan skala komputer virtual, lewati ke langkah 3 yang memperlihatkan Anda cara mempertahankan identitas terkelola yang ditetapkan pengguna sambil menghapus identitas terkelola yang ditetapkan sistem dari kumpulan skala komputer virtual Anda.

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PATCH -d '{"identity":{"type":"None"}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"None"
       }
    }
   

   Untuk menghapus identitas terkelola yang ditetapkan sistem dari kumpulan skala komputer virtual yang memiliki identitas terkelola yang ditetapkan pengguna, hapus SystemAssigned dari nilai {"identity":{"type:" "}} sambil mempertahankan nilai UserAssigned dan nilai kamus userAssignedIdentities jika Anda menggunakan versi API 2018-06-01. Jika Anda menggunakan versi API 2017-12-01 atau versi lebih lama, pertahankan array identityIds.

Identitas terkelola yang ditetapkan pengguna

Di bagian ini, Anda mempelajari cara menambahkan dan menghapus identitas terkelola yang ditetapkan pengguna pada set skala komputer virtual menggunakan CURL untuk melakukan panggilan ke titik akhir REST Azure Resource Manager.

Menetapkan identitas terkelola yang ditetapkan pengguna selama pembuatan set skala mesin virtual

1. Ambil token akses Bearer, yang akan Anda gunakan pada langkah berikutnya di header Otorisasi untuk membuat set skala mesin virtual Anda dengan identitas terkelola yang ditetapkan oleh sistem.

   az account get-access-token
   

2. Buat antarmuka jaringan untuk kumpulan skala komputer virtual Anda:

    az network nic create -g myResourceGroup --vnet-name myVnet --subnet mySubnet -n myNic
   

3. Ambil token akses Bearer, yang akan Anda gunakan pada langkah berikutnya di header Otorisasi untuk membuat set skala mesin virtual Anda dengan identitas terkelola yang ditetapkan oleh sistem.

   az account get-access-token
   

4. Buat identitas terkelola yang ditetapkan pengguna menggunakan instruksi yang ditemukan di sini: Membuat identitas terkelola yang ditetapkan pengguna.

5. Buat sekumpulan skala mesin virtual dengan menggunakan CURL untuk mengakses titik akhir REST Azure Resource Manager. Contoh berikut membuat kumpulan skala komputer virtual bernama myVMSS di grup sumber daya myResourceGroup dengan identitas terkelola yang ditetapkan sistem, ID1 seperti yang diidentifikasi dalam isi permintaan berdasarkan nilai "identity":{"type":"UserAssigned"}. Ganti <ACCESS TOKEN> dengan nilai yang Anda terima di langkah sebelumnya ketika Anda meminta token akses Bearer dan nilai <SUBSCRIPTION ID> yang sesuai untuk lingkungan Anda.

   API VERSI 2018-06-01

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PUT -d '{"sku":{"tier":"Standard","capacity":3,"name":"Standard_D1_v2"},"location":"eastus","identity":{"type":"UserAssigned","userAssignedIdentities":{"/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1":{}}},"properties":{"overprovision":true,"virtualMachineProfile":{"storageProfile":{"imageReference":{"sku":"2016-Datacenter","publisher":"MicrosoftWindowsServer","version":"latest","offer":"WindowsServer"},"osDisk":{"caching":"ReadWrite","managedDisk":{"storageAccountType":"StandardSSD_LRS"},"createOption":"FromImage"}},"osProfile":{"computerNamePrefix":"myVMSS","adminUsername":"azureuser","adminPassword":"myPassword12"},"networkProfile":{"networkInterfaceConfigurations":[{"name":"myVMSS","properties":{"primary":true,"enableIPForwarding":true,"ipConfigurations":[{"name":"myVMSS","properties":{"subnet":{"id":"/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubnet"}}}]}}]}},"upgradePolicy":{"mode":"Manual"}}}' -H "Content-Type: application/json" -H "Authorization: Bearer <ACCESS TOKEN>"
   

   PUT https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "sku":{
          "tier":"Standard",
          "capacity":3,
          "name":"Standard_D1_v2"
       },
       "location":"eastus",
       "identity":{
          "type":"UserAssigned",
          "userAssignedIdentities":{
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1":{
   
             }
          }
       },
       "properties":{
          "overprovision":true,
          "virtualMachineProfile":{
             "storageProfile":{
                "imageReference":{
                   "sku":"2016-Datacenter",
                   "publisher":"MicrosoftWindowsServer",
                   "version":"latest",
                   "offer":"WindowsServer"
                },
                "osDisk":{
                   "caching":"ReadWrite",
                   "managedDisk":{
                      "storageAccountType":"StandardSSD_LRS"
                   },
                   "createOption":"FromImage"
                }
             },
             "osProfile":{
                "computerNamePrefix":"myVMSS",
                "adminUsername":"azureuser",
                "adminPassword":"myPassword12"
             },
             "networkProfile":{
                "networkInterfaceConfigurations":[
                   {
                      "name":"myVMSS",
                      "properties":{
                         "primary":true,
                         "enableIPForwarding":true,
                         "ipConfigurations":[
                            {
                               "name":"myVMSS",
                               "properties":{
                                  "subnet":{
                                     "id":"/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubnet"
                                  }
                               }
                            }
                         ]
                      }
                   }
                ]
             }
          },
          "upgradePolicy":{
             "mode":"Manual"
          }
       }
    }
   

   API VERSI 2017-12-01

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01' -X PUT -d '{"sku":{"tier":"Standard","capacity":3,"name":"Standard_D1_v2"},"location":"eastus","identity":{"type":"UserAssigned","identityIds":["/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1"]},"properties":{"overprovision":true,"virtualMachineProfile":{"storageProfile":{"imageReference":{"sku":"2016-Datacenter","publisher":"MicrosoftWindowsServer","version":"latest","offer":"WindowsServer"},"osDisk":{"caching":"ReadWrite","managedDisk":{"storageAccountType":"StandardSSD_LRS"},"createOption":"FromImage"}},"osProfile":{"computerNamePrefix":"myVMSS","adminUsername":"azureuser","adminPassword":"myPassword12"},"networkProfile":{"networkInterfaceConfigurations":[{"name":"myVMSS","properties":{"primary":true,"enableIPForwarding":true,"ipConfigurations":[{"name":"myVMSS","properties":{"subnet":{"id":"/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubnet"}}}]}}]}},"upgradePolicy":{"mode":"Manual"}}}' -H "Content-Type: application/json" -H "Authorization: Bearer <ACCESS TOKEN>"
   

   PUT https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "sku":{
          "tier":"Standard",
          "capacity":3,
          "name":"Standard_D1_v2"
       },
       "location":"eastus",
       "identity":{
          "type":"UserAssigned",
          "identityIds":[
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1"
          ]
       },
       "properties":{
          "overprovision":true,
          "virtualMachineProfile":{
             "storageProfile":{
                "imageReference":{
                   "sku":"2016-Datacenter",
                   "publisher":"MicrosoftWindowsServer",
                   "version":"latest",
                   "offer":"WindowsServer"
                },
                "osDisk":{
                   "caching":"ReadWrite",
                   "managedDisk":{
                      "storageAccountType":"StandardSSD_LRS"
                   },
                   "createOption":"FromImage"
                }
             },
             "osProfile":{
                "computerNamePrefix":"myVMSS",
                "adminUsername":"azureuser",
                "adminPassword":"myPassword12"
             },
             "networkProfile":{
                "networkInterfaceConfigurations":[
                   {
                      "name":"myVMSS",
                      "properties":{
                         "primary":true,
                         "enableIPForwarding":true,
                         "ipConfigurations":[
                            {
                               "name":"myVMSS",
                               "properties":{
                                  "subnet":{
                                     "id":"/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubnet"
                                  }
                               }
                            }
                         ]
                      }
                   }
                ]
             }
          },
          "upgradePolicy":{
             "mode":"Manual"
          }
       }
    }
   

Menetapkan identitas terkelola yang ditetapkan pengguna ke skala set mesin virtual Azure yang ada

1. Ambil token akses Bearer, yang akan Anda gunakan pada langkah berikutnya di header Otorisasi untuk membuat set skala mesin virtual Anda dengan identitas terkelola yang ditetapkan oleh sistem.

   az account get-access-token
   

2. Buat identitas terkelola yang ditetapkan pengguna menggunakan instruksi yang ditemukan di sini, Membuat identitas terkelola yang ditetapkan pengguna.

3. Untuk memastikan Anda tidak menghapus identitas terkelola yang sudah ada yang ditetapkan oleh pengguna atau sistem ke grup skala mesin virtual, Anda perlu mencantumkan jenis-jenis identitas yang ditetapkan ke grup skala mesin virtual dengan menggunakan perintah CURL berikut. Jika Anda sudah mengelola identitas yang ditetapkan ke kumpulan skala komputer virtual, identitas tersebut tercantum di nilai identity.

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP>/providers/Microsoft.Compute/virtualMachineScaleSets/<VMSS NAME>?api-version=2018-06-01' -H "Authorization: Bearer <ACCESS TOKEN>"
   

   GET https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP>/providers/Microsoft.Compute/virtualMachineScaleSets/<VMSS NAME>?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

4. Jika Anda tidak memiliki identitas terkelola yang ditetapkan oleh pengguna atau sistem pada set skala mesin virtual Anda, gunakan perintah CURL berikut untuk memanggil titik akhir REST Azure Resource Manager guna menetapkan identitas terkelola pertama yang ditetapkan oleh pengguna ke set skala mesin virtual. Jika Anda memiliki identitas terkelola yang ditetapkan pengguna atau sistem yang ditetapkan ke kumpulan skala komputer virtual, lewati ke langkah 5 yang memperlihatkan Anda cara menambahkan beberapa identitas terkelola yang ditetapkan pengguna ke kumpulan skala komputer virtual sambil juga mempertahankan identitas terkelola yang ditetapkan sistem.

   Contoh berikut menetapkan identitas terkelola yang ditetapkan pengguna, ID1 ke kumpulan skala komputer virtual bernama myVMSS di grup sumber daya myResourceGroup. Ganti <ACCESS TOKEN> dengan nilai yang Anda terima di langkah sebelumnya ketika Anda meminta token akses Bearer dan nilai <SUBSCRIPTION ID> yang sesuai untuk lingkungan Anda.

   API VERSI 2018-06-01

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-12-01' -X PATCH -d '{"identity":{"type":"userAssigned", "userAssignedIdentities":{"/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1":{}}}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-12-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"userAssigned",
          "userAssignedIdentities":{
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1":{
   
             }
          }
       }
    }
   

   API VERSI 2017-12-01

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01' -X PATCH -d '{"identity":{"type":"userAssigned", "identityIds":["/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1"]}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"userAssigned",
          "identityIds":[
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1"
          ]
       }
    }
   

5. Jika Anda memiliki identitas terkelola yang ditetapkan oleh pengguna atau sistem pada kumpulan skala mesin virtual Anda:

   API VERSI 2018-06-01

   Tambahkan identitas terkelola yang pengguna tetapkan ke nilai kamus userAssignedIdentities.

   Misalnya, jika Anda memiliki identitas terkelola yang ditetapkan sistem dan identitas terkelola yang ditetapkan pengguna ID1 yang saat ini ditetapkan ke kumpulan skala komputer virtual Anda dan ingin menambahkan identitas terkelola yang ditetapkan pengguna ID2 ke identitas tersebut:

   curl  'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PATCH -d '{"identity":{"type":"SystemAssigned, UserAssigned", "userAssignedIdentities":{"/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1":{},"/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2":{}}}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"SystemAssigned, UserAssigned",
          "userAssignedIdentities":{
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1":{
   
             },
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2":{
   
             }
          }
       }
    }
   

   API VERSI 2017-12-01

   Pertahankan identitas terkelola yang ditetapkan pengguna yang ingin Anda simpan dalam nilai array identityIds sambil menambahkan identitas terkelola yang ditetapkan pengguna baru.

   Misalnya, jika Anda memiliki identitas yang ditetapkan sistem dan identitas terkelola yang ditetapkan pengguna ID1 yang saat ini ditetapkan ke kumpulan skala komputer virtual Anda dan ingin menambahkan identitas terkelola yang ditetapkan pengguna ID2 ke identitas tersebut:

   curl  'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01' -X PATCH -d '{"identity":{"type":"SystemAssigned, UserAssigned", "identityIds":["/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1","/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2"]}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"SystemAssigned, UserAssigned",
          "identityIds":[
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1",
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2"
          ]
       }
    }
   

Menghapus identitas terkelola yang ditetapkan pengguna dari kumpulan skala komputer virtual

1. Ambil token akses Bearer, yang akan Anda gunakan pada langkah berikutnya di header Otorisasi untuk membuat set skala mesin virtual Anda dengan identitas terkelola yang ditetapkan oleh sistem.

   az account get-access-token
   

2. Untuk memastikan Anda tidak menghapus identitas terkelola yang ditetapkan pengguna yang sudah ada yang tetap ingin Anda tetapkan ke kumpulan skala komputer virtual atau menghapus identitas terkelola yang ditetapkan sistem, Anda perlu mencantumkan identitas terkelola dengan menggunakan perintah CURL berikut:

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP>/providers/Microsoft.Compute/virtualMachineScaleSets/<VMSS NAME>?api-version=2018-06-01' -H "Authorization: Bearer <ACCESS TOKEN>" 
   

   GET https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP>/providers/Microsoft.Compute/virtualMachineScaleSets/<VMSS NAME>?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Jika Anda sudah mengelola identitas yang ditetapkan ke komputer virtual, identitas tersebut tercantum dalam respons dalam nilai identity.

   Misalnya, jika Anda memiliki identitas terkelola yang ditetapkan pengguna ID1 dan ID2 yang ditetapkan ke kumpulan skala komputer virtual Anda, dan Anda hanya ingin tetap menetapkan ID1 dan mempertahankan identitas terkelola yang ditetapkan sistem:

   API VERSI 2018-06-01

   Tambahkan null ke identitas terkelola yang ditetapkan pengguna yang ingin Anda hapus:

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PATCH -d '{"identity":{"type":"SystemAssigned, UserAssigned", "userAssignedIdentities":{"/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2":null}}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"SystemAssigned, UserAssigned",
          "userAssignedIdentities":{
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID2":null
          }
       }
    }
   

   API VERSI 2017-12-01

   Hanya pertahankan identitas terkelola yang ditetapkan pengguna yang ingin Anda simpan dalam array identityIds:

   curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01' -X PATCH -d '{"identity":{"type":"SystemAssigned,UserAssigned", "identityIds":["/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1"]}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"
   

   PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2017-12-01 HTTP/1.1
   

   Header permintaan

   Header permintaan	Deskripsi
   Content-Type	Harus diisi. Atur ke application/json.
   Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

   Badan permintaan

    {
       "identity":{
          "type":"SystemAssigned,UserAssigned",
          "identityIds":[
             "/subscriptions/<SUBSCRIPTION ID>/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ID1"
          ]
       }
    }
   

Jika kumpulan skala komputer virtual Anda memiliki identitas terkelola yang ditetapkan sistem dan ditetapkan pengguna, Anda dapat menghapus semua identitas terkelola yang ditetapkan pengguna dengan beralih untuk hanya menggunakan yang ditetapkan sistem menggunakan perintah berikut:

curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PATCH -d '{"identity":{"type":"SystemAssigned"}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"

PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1

Header permintaan

Header permintaan	Deskripsi
Content-Type	Harus diisi. Atur ke application/json.
Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

Badan permintaan

{
   "identity":{
      "type":"SystemAssigned"
   }
}

Jika kumpulan skala komputer virtual Anda hanya memiliki identitas terkelola yang ditetapkan pengguna dan Anda ingin menghapus semuanya, gunakan perintah berikut:

curl 'https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01' -X PATCH -d '{"identity":{"type":"None"}}' -H "Content-Type: application/json" -H Authorization:"Bearer <ACCESS TOKEN>"

PATCH https://management.azure.com/subscriptions/<SUBSCRIPTION ID>/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVMSS?api-version=2018-06-01 HTTP/1.1

Header permintaan

Header permintaan	Deskripsi
Content-Type	Harus diisi. Atur ke application/json.
Otorisasi	Harus diisi. Atur ke token akses Bearer yang valid.

Badan permintaan

{
   "identity":{
      "type":"None"
   }
}

Langkah berikutnya

Untuk informasi tentang cara membuat, mencantumkan, atau menghapus identitas terkelola yang ditetapkan pengguna menggunakan REST, lihat:

• Membuat, mencantumkan, atau menghapus identitas terkelola yang ditetapkan pengguna menggunakan panggilan REST API