Ringkasan Penyedia Sumber Daya Kustom Azure
Penyedia Sumber Daya Kustom Azure adalah platform ekstensibilitas untuk Azure. Platform ini memungkinkan Anda menentukan API kustom yang dapat digunakan untuk memperkaya pengalaman default Azure. Dokumentasi ini menjelaskan:
- Cara membangun dan menyebarkan Penyedia Sumber Daya Kustom Azure.
- Cara menggunakan Penyedia Sumber Daya Kustom Azure untuk memperluas alur kerja yang ada.
- Tempat panduan dan sampel kode untuk memulai.
Penting
Penyedia Sumber Daya Kustom saat ini dalam pratinjau publik. Versi pratinjau ini diberikan tanpa perjanjian tingkat layanan, dan tidak disarankan untuk beban kerja produksi. Fitur tertentu mungkin tidak didukung atau mungkin memiliki kemampuan terbatas. Selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.
Apa yang bisa dilakukan oleh penyedia sumber daya kustom
Berikut adalah beberapa contoh yang bisa Anda capai dengan Penyedia Sumber Daya Kustom Azure:
- Memperluas REST API Azure Resource Manager agar menyertakan layanan internal dan eksternal.
- Mengaktifkan skenario kustom di atas alur kerja Azure yang sudah ada.
- Kustomisasi kontrol dan efek Azure Resource Manager.
Apa itu penyedia sumber daya kustom
Penyedia Sumber Daya Kustom Azure dibuat dengan membuat kontrak antara Azure dan titik akhir. Kontrak ini mendefinisikan daftar sumber daya dan tindakan baru melalui sumber daya baru, Microsoft.CustomProviders/resourceProviders. Penyedia sumber daya kustom kemudian akan mengekspos API baru ini di Azure. Penyedia Sumber Daya Kustom Azure terdiri dari tiga bagian: penyedia sumber daya kustom, titik akhir, dan sumber daya kustom.
Cara membangun penyedia sumber daya kustom
Penyedia sumber daya kustom adalah daftar kontrak antara Azure dan titik akhir. Kontrak-kontrak ini menjelaskan bagaimana Azure harus berinteraksi dengan titik akhir mereka. Penyedia sumber daya bertindak seperti proksi dan akan meneruskan permintaan dan respons ke dan dari titik akhir yang ditentukan. Penyedia sumber daya dapat menentukan dua jenis kontrak: resourceTypes dan actions. Kontrak ini diaktifkan melalui definisi titik akhir. Definisi titik akhir terdiri dari tiga bidang: nama,routingType, dan titik akhir.
Sampel Titik Akhir:
{
"name": "{endpointDefinitionName}",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
| Properti | Diperlukan | Deskripsi |
|---|---|---|
| nama | ya | Nama definisi titik akhir. Azure mengekspos nama ini melalui API di ‘/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ resourceProviders/{resourceProviderName}/{endpointDefinitionName}' |
| routingType | tidak | Tentukan jenis kontrak dengan titik akhir. Jika tidak ditentukan, jenis kontrak akan menjadi "Proksi". |
| titik akhir | ya | Titik akhir untuk merutekan permintaan. Cara ini akan menangani respons serta efek samping dari permintaan. |
Membangun sumber daya kustom
ResourceTypes menjelaskan sumber daya kustom baru yang ditambahkan ke Azure. Sumber daya kustom ini mengekspos metode RESTful CRUD dasar. Selengkapnya tentang membuat sumber daya kustom
Contoh Penyedia Sumber Daya Kustom dengan resourceTypes:
{
"properties": {
"resourceTypes": [
{
"name": "myCustomResources",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
API ditambahkan ke Azure untuk sampel di atas:
| HttpMethod | Contoh URI | Deskripsi |
|---|---|---|
| TEMPATKAN | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Panggilan REST API Azure untuk membuat sumber daya baru. |
| HAPUS | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Panggilan REST API Azure untuk menghapus sumber daya yang ada. |
| DAPATKAN | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Panggilan REST API Azure untuk mengambil sumber daya yang ada. |
| DAPATKAN | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources?api-version=2018-09-01-preview |
Panggilan REST API Azure untuk mengambil daftar sumber daya yang ada. |
Membangun tindakan kustom
Tindakan menjelaskan tindakan baru yang ditambahkan ke Azure. Tindakan ini dapat diekspos di atas penyedia sumber daya atau disarangkan di bawah resourceType. Selengkapnya tentang membuat tindakan kustom
Sampel Penyedia Sumber Daya Kustom dengan tindakan:
{
"properties": {
"actions": [
{
"name": "myCustomAction",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
API ditambahkan ke Azure untuk sampel di atas:
| HttpMethod | Contoh URI | Deskripsi |
|---|---|---|
| POSTING | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomAction?api-version=2018-09-01-preview |
Panggilan REST API Azure untuk mengaktifkan tindakan. |
Cari bantuan
Jika Anda memiliki pertanyaan tentang pengembangan Penyedia Sumber Daya Kustom Azure, coba tanyakan di Stack Overflow. Pertanyaan serupa mungkin sudah dijawab, jadi periksa terlebih dulu sebelum memposting. Tambahkan tag azure-custom-providers untuk mendapatkan respons cepat!
Langkah berikutnya
Dalam artikel ini, Anda mempelajari tentang penyedia sumber daya kustom. Buka artikel berikutnya untuk membuat penyedia sumber daya kustom.