Ringkasan Penyedia Sumber Daya Kustom Azure

Artikel
06/01/2023

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.

Diagram Penyedia Sumber Daya Kustom Azure, menampilkan hubungan antara Azure Resource Manager, penyedia sumber daya kustom, dan sumber daya.

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.

Bagikan melalui