Share via

Menggunakan profil versi API dengan .NET di Azure Stack Hub

  • Artikel

Penting

.NET SDK telah diperbarui dari trek 1 ke trek 2. Kami sangat menyarankan untuk bermigrasi ke SDK trek 2 sesegera mungkin. Silakan lihat panduan migrasi ini untuk mengetahui petunjuknya.

SDK .NET untuk Azure Stack Hub Resource Manager menyediakan alat untuk membantu Anda membangun dan mengelola infrastruktur Anda. Penyedia sumber di SDK mencakup Azure Compute, Jaringan, Storage, App Services, dan Key Vault. SDK .NET mencakup 14 paket NuGet. Jika Anda menggunakan track 1 .NET SDK yang tidak digunakan lagi (tidak disarankan), paket ini diberi versi dengan profil API, seperti 2020-09-01-hybrid dan 2019-03-01-hybrid. Profil API di .NET SDK memungkinkan pengembangan cloud hibrid dengan membantu Anda beralih antara sumber daya Azure global dan sumber daya Azure Stack Hub. Lihat bagian profil versi .NET dan API untuk informasi selengkapnya.

Menginstal SDK .NET Azure

Profil versi .NET dan API

Profil API adalah kombinasi dari penyedia sumber dan versi API. Gunakan profil API untuk mendapatkan versi terbaru dan paling stabil dari setiap jenis sumber daya dalam paket penyedia sumber.

Catatan

Bagian ResourceProvider dari spesifikasi paket NuGet harus diubah. Selain itu, paket untuk track 1 .NET SDK tidak digunakan lagi, sehingga Anda mungkin menghadapi kesalahan. Sebaiknya perbarui ke track 2 .NET SDK sesegera mungkin.

Profil

Untuk profil yang berisi tanggal, untuk menggunakan profil atau versi SDK yang berbeda, ganti tanggal di Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager. Misalnya, untuk versi 2008, profilnya adalah 2019_03_01, dan string menjadi Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. Perhatikan bahwa terkadang tim SDK mengubah nama paket, jadi hanya mengganti tanggal string dengan tanggal yang berbeda mungkin tidak berhasil. Lihat tabel berikut untuk asosiasi profil dan versi Azure Stack.

Versi Azure Stack Profil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020_09_01
2102 2020_09_01
2008 2019_03_01

Untuk informasi selengkapnya tentang Azure Stack Hub serta profil API, lihat Ringkasan profil API.

Langganan

Jika Anda belum memiliki langganan, buat langganan dan simpan ID langganan yang akan digunakan nanti. Untuk informasi tentang cara membuat langganan, lihat dokumen ini.

Perwakilan Layanan

Perwakilan layanan dan informasi lingkungan terkait harus dibuat dan disimpan di suatu tempat. Perwakilan layanan dengan peran owner direkomendasikan, tetapi tergantung sampel, peran contributor mungkin sudah cukup. Lihat README di repositori sampel untuk nilai yang diperlukan. Anda dapat membaca nilai-nilai ini dalam format apa pun yang didukung oleh bahasa SDK seperti dari file JSON (yang digunakan dalam sampel kami). Bergantung pada sampel yang dijalankan, tidak semua nilai ini dapat digunakan. Lihat repositori sampel untuk mengetahui kode sampel terbaru atau informasi lebih lanjut.

ID Penyewa

Ikuti petunjuk dalam artikel ini untuk menemukan direktori atau ID penyewa untuk Azure Stack Hub Anda.

Mendaftarkan penyedia sumber daya

Daftarkan penyedia sumber daya yang diperlukan dengan mengikuti dokumen ini. Penyedia sumber daya ini akan diperlukan, tergantung sampel yang ingin Anda jalankan. Misalnya, jika Anda ingin menjalankan sampel mesin virtual, pendaftaran penyedia sumber daya Microsoft.Compute diperlukan.

Titik akhir Azure Stack resource manager

Azure Resource Manager (ARM) adalah kerangka kerja manajemen yang memungkinkan administrator untuk menyebarkan, mengelola, dan memantau sumber daya Azure. Azure Resource Manager dapat menangani tugas-tugas ini sebagai grup, bukan secara individu, dalam satu operasi. Anda bisa mendapatkan info metadata dari titik akhir Resource Manager. Titik akhir mengembalikan file JSON dengan info yang dibutuhkan untuk menjalankan kode Anda.

  • ResourceManagerEndpointUrl di Azure Stack Development Kit (ASDK) adalah: https://management.local.azurestack.external/.
  • ResourceManagerEndpointUrl dalam sistem terintegrasi adalah: https://management.region.<fqdn>/, dengan <fqdn> adalah nama domain Anda yang sepenuhnya memenuhi syarat.
  • Untuk mengambil metadata yang dibutuhkan: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Untuk versi API yang tersedia, lihat Spesifikasi rest API Azure. Misalnya, dalam versi profil 2020-09-01, Anda dapat mengubah api-version ke 2019-10-01 untuk penyedia sumber daya microsoft.resources.

JSON Sampel:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Sampel

Lihat repositori sampel ini untuk kode sampel update-to-date (track 2). Lihat repositori sampel ini untuk kode sampel trek 1. Akar README.md menjelaskan persyaratan umum, dan setiap subdirektori berisi sampel tertentu dengan sendirinya README.md yang menjelaskan cara menjalankan sampel tersebut.

Lihat di sini untuk mengetahui sampel yang berlaku pada versi 2008 atau profil 2019-03-01 Azure Stack dan di bawah ini.

Langkah berikutnya

Pelajari selengkapnya tentang profil API: