Menggunakan profil versi API dengan Go di Azure Stack Hub

Artikel
10/30/2024

Go dan profil versi

Profil adalah kombinasi dari jenis sumber daya yang berbeda dengan versi yang berbeda, dari layanan yang berbeda. Menggunakan profil membantu Anda mencampur dan mencocokkan antara berbagai jenis sumber daya. Profil dapat memberikan manfaat berikut:

Stabilitas untuk aplikasi Anda dengan mengunci ke versi API tertentu.
Kompatibilitas untuk aplikasi Anda dengan Azure Stack Hub dan pusat data Azure regional.

Di SDK Go, profil tersedia di bawah jalur profil. Nomor versi profil diberi label dalam format YYYY-MM-DD. Misalnya, versi profil API Azure Stack Hub terbaru 2020-09-01 adalah untuk Azure Stack Hub versi 2102 atau yang lebih baru. Untuk mengimpor layanan tertentu dari profil, impor modul yang sesuai dari profil. Misalnya, untuk mengimpor layanan Azure Compute dari profil 2020-09-01, gunakan kode berikut:

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

Menginstal SDK Azure untuk Go

Pasang Git. Lihat Memulai - Memasang Git.
Instal Go. Profil API untuk Azure memerlukan Go versi 1.9 atau yang lebih baru. Lihat Bahasa pemrograman Go.

Profil

Untuk menggunakan profil atau versi SDK yang berbeda, ganti tanggal dalam pernyataan impor seperti github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Misalnya, untuk versi 2008, profilnya adalah 2019-03-01, dan string menjadi github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. 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.

Lihat profil Go SDK.

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 untuk mengetahui kode sampel terbaru. Akar README.md menjelaskan persyaratan umum, dan setiap subdirektori berisi sampel tertentu dengan README.md masing-masing tentang 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:

Bagikan melalui