Bagikan melalui

Penyedia dan jenis sumber daya Azure

Penyedia sumber daya Azure adalah sekumpulan operasi REST yang mendukung fungsionalitas untuk layanan Azure tertentu. Misalnya, layanan Azure Key Vault terdiri dari penyedia sumber daya bernama Microsoft.KeyVault. Penyedia sumber daya mendefinisikan operasi REST untuk mengelola vault, rahasia, kunci, dan sertifikat.

Penyedia sumber daya menentukan sumber daya Azure yang dapat Anda sebarkan ke akun Anda. Nama jenis sumber daya mengikuti format: {resource-provider}/{resource-type}. Jenis sumber daya untuk brankas kunci adalah Microsoft.KeyVault/vaults.

Dalam artikel ini, Anda akan mempelajari cara:

  • Lihat semua penyedia sumber daya di Azure.
  • Periksa status pendaftaran penyedia sumber daya.
  • Mendaftarkan penyedia sumber.
  • Lihat jenis sumber daya untuk penyedia sumber daya.
  • Lihat lokasi yang valid untuk jenis sumber daya.
  • Lihat versi API yang valid untuk jenis sumber daya.

Untuk daftar yang memetakan penyedia sumber daya ke layanan Azure, lihat Penyedia dan jenis sumber daya Azure.

Mendaftarkan penyedia sumber daya

Sebelum Anda menggunakan penyedia sumber daya, pastikan langganan Azure Anda terdaftar untuk penyedia sumber daya. Pendaftaran mengonfigurasi langganan Anda untuk bekerja dengan penyedia sumber daya.

Penting

Daftarkan penyedia sumber daya hanya saat Anda siap menggunakannya. Langkah pendaftaran ini membantu mempertahankan hak istimewa paling sedikit dalam langganan Anda. Pengguna berbahaya tidak dapat menggunakan penyedia sumber daya yang tidak terdaftar.

Saat Anda mendaftarkan penyedia sumber daya, Microsoft menambahkan aplikasi untuk penyedia sumber daya. Mendaftarkan penyedia sumber daya yang tidak perlu dapat menyebabkan aplikasi yang tidak Anda kenali muncul di penyewa Microsoft Entra Anda. Windows Azure Service Management API biasanya menambahkan aplikasi ini. Untuk membatasi aplikasi yang tidak perlu di penyewa Anda, hanya daftarkan penyedia sumber daya yang Anda butuhkan.

Beberapa penyedia sumber daya didaftarkan secara default. Untuk daftar contoh, lihat Penyedia sumber daya untuk layanan Azure.

Saat Anda mengambil tindakan tertentu, Azure secara otomatis mendaftarkan penyedia sumber daya lainnya. Saat Anda membuat sumber daya di portal Azure, portal biasanya mendaftarkan penyedia sumber daya untuk Anda. Saat Anda menyebarkan templat Azure Resource Manager atau file Bicep, Azure secara otomatis mendaftarkan penyedia sumber daya yang ditentukan dalam templat. Terkadang, sumber daya dalam templat memerlukan sumber daya pendukung yang tidak ada dalam templat. Contoh umumnya adalah pemantauan atau sumber daya keamanan. Anda perlu mendaftarkan penyedia sumber daya tersebut secara manual.

Anda mungkin perlu mendaftarkan penyedia sumber daya secara manual selama skenario lain.

Penting

Kode aplikasi Anda tidak boleh memblokir pembuatan sumber daya untuk penyedia sumber daya yang berada dalam status mendaftar . Saat Anda mendaftarkan penyedia sumber daya, operasi dilakukan satu per satu untuk setiap wilayah yang didukung. Untuk membuat sumber daya di suatu wilayah, pendaftaran hanya perlu diselesaikan di wilayah tersebut. Ketika aplikasi Anda tidak memblokir penyedia sumber daya dalam status mendaftar, aplikasi dapat berlanjut lebih cepat daripada menunggu semua wilayah selesai.

Anda harus memiliki izin untuk melakukan /register/action operasi untuk penyedia sumber daya. Izin disertakan dalam peran Kontributor dan Pemilik.

Anda tidak bisa membatalkan pendaftaran penyedia sumber daya saat Anda masih memiliki tipe sumber daya dari penyedia sumber daya tersebut di langganan Anda.

Daftarkan ulang penyedia sumber daya saat penyedia sumber mendukung lokasi baru yang perlu Anda gunakan.

Portal Azure

Mendaftarkan penyedia sumber daya

Untuk melihat semua penyedia sumber daya dan status pendaftaran untuk langganan Anda:

  1. Masuk ke portal Azure.

  2. Pada menu portal Microsoft Azure, cari Langganan. Pilih dari opsi yang tersedia.

    Cuplikan layar pencarian langganan di portal Azure.

  3. Pilih langganan yang ingin Anda tampilkan.

  4. Di menu sebelah kiri dan di bawah Pengaturan, pilih Penyedia sumber daya.

    Cuplikan layar memilih penyedia sumber daya di portal Azure.

  5. Temukan penyedia sumber daya yang ingin Anda daftarkan.

    Cuplikan layar menemukan penyedia sumber daya di portal Azure.

  6. Pilih penyedia sumber daya untuk melihat detail penyedia sumber daya.

    Cuplikan layar detail Penyedia sumber daya di portal Azure.

  7. Pilih penyedia sumber daya, dan pilih Daftar. Untuk mempertahankan hak istimewa paling sedikit dalam langganan Anda, hanya daftarkan penyedia sumber daya yang siap Anda gunakan.

    Cuplikan layar mendaftarkan penyedia sumber daya di portal Azure.

    Penting

    Seperti disebutkan sebelumnya, jangan blokir pembuatan sumber daya untuk penyedia sumber daya yang berada dalam status mendaftar . Ketika aplikasi Anda tidak memblokir penyedia sumber daya dalam status mendaftar, aplikasi dapat berlanjut lebih cepat daripada menunggu semua wilayah selesai.

  8. Daftarkan ulang penyedia sumber daya untuk menggunakan lokasi yang Anda tambahkan sejak pendaftaran sebelumnya.

    Cuplikan layar pendaftaran ulang penyedia sumber daya di portal Azure.

Tampilkan penyedia sumber daya

Untuk melihat informasi untuk penyedia sumber daya tertentu:

  1. Masuk ke portal Azure.

  2. Pilih Semua layanan di menu portal Azure.

  3. Dalam kotak Semua layanan , masukkan penjelajah sumber daya, dan pilih Resource Explorer.

    Cuplikan layar memilih Semua layanan di portal Azure untuk mengakses Azure Resource Explorer.

  4. Pilih panah kanan untuk memperluas Penyedia.

    Cuplikan layar memperluas bagian Penyedia di Resource Explorer.

  5. Perluas penyedia sumber daya dan jenis sumber daya yang ingin Anda lihat.

  6. Resource Manager didukung di semua wilayah, tetapi sumber daya yang Anda terapkan mungkin tidak didukung di semua wilayah. Selain itu, mungkin ada batasan pada langganan Anda yang mencegah Anda menggunakan beberapa wilayah yang mendukung sumber daya. Resource Explorer menampilkan lokasi yang valid untuk jenis sumber daya.

    Cuplikan layar menampilkan lokasi yang valid untuk jenis sumber daya di Resource Explorer.

  7. Versi API sesuai dengan versi operasi REST API penyedia sumber daya. Sebagai penyedia sumber yang memungkinkan fitur baru, versi baru REST API dirilis. Resource Explorer menampilkan versi API yang valid untuk jenis sumber daya.

    Cuplikan layar menampilkan versi API yang valid untuk jenis sumber daya di Resource Explorer.

Azure PowerShell

Untuk melihat semua penyedia sumber daya di Azure dan status pendaftaran untuk langganan Anda, gunakan:

Get-AzResourceProvider -ListAvailable | Select-Object ProviderNamespace, RegistrationState

Perintah kembali:

ProviderNamespace                RegistrationState
-------------------------------- ------------------
Microsoft.ClassicCompute         Registered
Microsoft.ClassicNetwork         Registered
Microsoft.ClassicStorage         Registered
Microsoft.CognitiveServices      Registered
...

Untuk melihat semua penyedia sumber yang terdaftar untuk langganan Anda, gunakan:

 Get-AzResourceProvider -ListAvailable | Where-Object RegistrationState -eq "Registered" | Select-Object ProviderNamespace, RegistrationState | Sort-Object ProviderNamespace

Untuk mempertahankan hak istimewa paling kecil dalam langganan Anda, hanya daftarkan penyedia sumber daya yang siap Anda gunakan. Untuk mendaftarkan penyedia sumber, gunakan:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

Perintah kembali:

ProviderNamespace : Microsoft.Batch
RegistrationState : Registering
ResourceTypes     : {batchAccounts, operations, locations, locations/quotas}
Locations         : {West Europe, East US, East US 2, West US...}

Penting

Seperti disebutkan sebelumnya, jangan blokir pembuatan sumber daya untuk penyedia sumber daya yang berada dalam status mendaftar . Ketika aplikasi Anda tidak memblokir penyedia sumber daya dalam status mendaftar, aplikasi dapat berlanjut lebih cepat daripada menunggu semua wilayah selesai.

Untuk menggunakan lokasi yang ditambahkan Azure sejak pendaftaran sebelumnya, daftarkan penyedia sumber daya lagi. Untuk mendaftar ulang, jalankan perintah pendaftaran lagi.

Untuk melihat informasi untuk penyedia sumber tertentu, gunakan:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

Perintah kembali:

{ProviderNamespace : Microsoft.Batch
RegistrationState : Registered
ResourceTypes     : {batchAccounts}
Locations         : {West Europe, East US, East US 2, West US...}

...

Untuk melihat tipe sumber daya untuk penyedia sumber, gunakan:

(Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes.ResourceTypeName

Perintah kembali:

batchAccounts
operations
locations
locations/quotas

Versi API sesuai dengan versi operasi REST API penyedia sumber daya. Sebagai penyedia sumber yang memungkinkan fitur baru, versi baru REST API dirilis.

Untuk mendapatkan versi API yang tersedia untuk jenis sumber daya, gunakan:

((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).ApiVersions

Perintah kembali:

2023-05-01
2022-10-01
2022-06-01
2022-01-01
2021-06-01
2021-01-01
...

Resource Manager didukung di semua wilayah, tetapi sumber daya yang Anda terapkan mungkin tidak didukung di semua wilayah. Selain itu, mungkin ada batasan pada langganan Anda yang mencegah Anda menggunakan beberapa wilayah yang mendukung sumber daya.

Untuk mendapatkan lokasi yang didukung untuk jenis sumber daya, gunakan:

((Get-AzResourceProvider -ProviderNamespace Microsoft.Batch).ResourceTypes | Where-Object ResourceTypeName -eq batchAccounts).Locations

Perintah kembali:

West Europe
East US
East US 2
West US
...

Azure CLI

Untuk melihat semua penyedia sumber daya di Azure dan status pendaftaran untuk langganan Anda, gunakan:

az provider list --query "[].{Provider:namespace, Status:registrationState}" --out table

Perintah kembali:

Provider                         Status
-------------------------------- ----------------
Microsoft.ClassicCompute         Registered
Microsoft.ClassicNetwork         Registered
Microsoft.ClassicStorage         Registered
Microsoft.CognitiveServices      Registered
...

Untuk melihat semua penyedia sumber yang terdaftar untuk langganan Anda, gunakan:

az provider list --query "sort_by([?registrationState=='Registered'].{Provider:namespace, Status:registrationState}, &Provider)" --out table

Untuk mempertahankan hak istimewa paling kecil dalam langganan Anda, hanya daftarkan penyedia sumber daya yang siap Anda gunakan. Untuk mendaftarkan penyedia sumber, gunakan:

az provider register --namespace Microsoft.Batch

Perintah mengembalikan pesan bahwa pendaftaran sedang berlangsung.

Untuk melihat informasi untuk penyedia sumber tertentu, gunakan:

az provider show --namespace Microsoft.Batch

Perintah kembali:

{
    "id": "/subscriptions/####-####/providers/Microsoft.Batch",
    "namespace": "Microsoft.Batch",
    "registrationsState": "Registering",
    "resourceTypes:" [
        ...
    ]
}

Penting

Seperti disebutkan sebelumnya, jangan blokir pembuatan sumber daya untuk penyedia sumber daya yang berada dalam status mendaftar . Ketika aplikasi Anda tidak memblokir penyedia sumber daya dalam status mendaftar, aplikasi dapat berlanjut lebih cepat daripada menunggu semua wilayah selesai.

Untuk melihat tipe sumber daya untuk penyedia sumber, gunakan:

az provider show --namespace Microsoft.Batch --query "resourceTypes[*].resourceType" --out table

Perintah kembali:

Result
---------------
batchAccounts
operations
locations
locations/quotas

Versi API sesuai dengan versi operasi REST API penyedia sumber daya. Sebagai penyedia sumber yang memungkinkan fitur baru, versi baru REST API dirilis.

Untuk mendapatkan versi API yang tersedia untuk jenis sumber daya, gunakan:

az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].apiVersions | [0]" --out table

Perintah kembali:

Result
---------------
2023-05-01
2022-10-01
2022-06-01
2022-01-01
...

Resource Manager didukung di semua wilayah, tetapi sumber daya yang Anda terapkan mungkin tidak didukung di semua wilayah. Selain itu, mungkin ada batasan pada langganan Anda yang mencegah Anda menggunakan beberapa wilayah yang mendukung sumber daya.

Untuk mendapatkan lokasi yang didukung untuk jenis sumber daya, gunakan:

az provider show --namespace Microsoft.Batch --query "resourceTypes[?resourceType=='batchAccounts'].locations | [0]" --out table

Perintah kembali:

Result
---------------
West Europe
East US
East US 2
West US
...

Python

Untuk melihat semua penyedia sumber daya di Azure dan status pendaftaran untuk langganan Anda, gunakan:

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# List available resource providers and select ProviderNamespace and RegistrationState  
providers = resource_management_client.providers.list()  
  
for provider in providers:  
    print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}")

Perintah kembali:

ProviderNamespace: Microsoft.AlertsManagement, RegistrationState: Registered
ProviderNamespace: Microsoft.AnalysisServices, RegistrationState: Registered
ProviderNamespace: Microsoft.ApiManagement, RegistrationState: Registered
ProviderNamespace: Microsoft.Authorization, RegistrationState: Registered
ProviderNamespace: Microsoft.Batch, RegistrationState: Registered
...

Untuk melihat semua penyedia sumber yang terdaftar untuk langganan Anda, gunakan:

# List available resource providers with RegistrationState "Registered" and select ProviderNamespace and RegistrationState  
providers = resource_management_client.providers.list()  
registered_providers = [provider for provider in providers if provider.registration_state == "Registered"]  
  
# Sort by ProviderNamespace  
sorted_registered_providers = sorted(registered_providers, key=lambda x: x.namespace)  
  
for provider in sorted_registered_providers:  
    print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}")

Untuk mempertahankan hak istimewa paling kecil dalam langganan Anda, hanya daftarkan penyedia sumber daya yang siap Anda gunakan. Untuk mendaftarkan penyedia sumber, gunakan:

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# Register resource provider  
provider_namespace = "Microsoft.Batch"  
registration_result = resource_management_client.providers.register(provider_namespace)  
  
print(f"ProviderNamespace: {registration_result.namespace}, RegistrationState: {registration_result.registration_state}")

Perintah kembali:

ProviderNamespace: Microsoft.Batch, RegistrationState: Registered

Penting

Seperti disebutkan sebelumnya, jangan blokir pembuatan sumber daya untuk penyedia sumber daya yang berada dalam status mendaftar . Ketika aplikasi Anda tidak memblokir penyedia sumber daya dalam status mendaftar, aplikasi dapat berlanjut lebih cepat daripada menunggu semua wilayah selesai.

Daftarkan ulang penyedia sumber daya untuk menggunakan lokasi yang ditambahkan Azure sejak pendaftaran sebelumnya. Untuk mendaftar ulang, jalankan perintah pendaftaran lagi.

Untuk melihat informasi untuk penyedia sumber tertentu, gunakan:

import os  
from azure.identity import DefaultAzureCredential  
from azure.mgmt.resource import ResourceManagementClient  
  
# Authentication  
credential = DefaultAzureCredential()  
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]  
  
# Initialize Resource Management client  
resource_management_client = ResourceManagementClient(credential, subscription_id)  
  
# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
print(f"ProviderNamespace: {provider.namespace}, RegistrationState: {provider.registration_state}\n")  
  
# Add resource types, locations, and API versions with new lines to separate results  
for resource_type in provider.resource_types:  
    print(f"ResourceType: {resource_type.resource_type}\nLocations: {', '.join(resource_type.locations)}\nAPIVersions: {', '.join(resource_type.api_versions)}\n")

Perintah kembali:

ProviderNamespace: Microsoft.Batch, RegistrationState: Registered

ResourceType: batchAccounts
Locations: West Europe, East US, East US 2, West US, North Central US, Brazil South, North Europe, Central US, East Asia, Japan East, Australia Southeast, Japan West, Korea South, Korea Central, Southeast Asia, South Central US, Australia East, Jio India West, South India, Central India, West India, Canada Central, Canada East, UK South, UK West, West Central US, West US 2, France Central, South Africa North, UAE North, Australia Central, Germany West Central, Switzerland North, Norway East, Brazil Southeast, West US 3, Sweden Central, Qatar Central, Poland Central, East US 2 EUAP, Central US EUAP
APIVersions: 2023-05-01, 2022-10-01, 2022-06-01, 2022-01-01, 2021-06-01, 2021-01-01, 2020-09-01, 2020-05-01, 2020-03-01-preview, 2020-03-01, 2019-08-01, 2019-04-01, 2018-12-01, 2017-09-01, 2017-05-01, 2017-01-01, 2015-12-01, 2015-09-01, 2015-07-01, 2014-05-01-privatepreview

...

Untuk melihat tipe sumber daya untuk penyedia sumber, gunakan:

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Get ResourceTypeName of the resource types  
resource_type_names = [resource_type.resource_type for resource_type in provider.resource_types]  
  
for resource_type_name in resource_type_names:  
    print(resource_type_name)

Perintah kembali:

batchAccounts
batchAccounts/pools
batchAccounts/detectors
batchAccounts/certificates
operations
locations
locations/quotas
locations/checkNameAvailability
locations/accountOperationResults
locations/virtualMachineSkus
locations/cloudServiceSkus

Versi API sesuai dengan versi operasi REST API penyedia sumber daya. Sebagai penyedia sumber yang memungkinkan fitur baru, versi baru REST API dirilis.

Untuk mendapatkan versi API yang tersedia untuk jenis sumber daya, gunakan:

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Filter resource type by ResourceTypeName and get its ApiVersions  
resource_type_name = "batchAccounts"  
api_versions = [  
    resource_type.api_versions  
    for resource_type in provider.resource_types  
    if resource_type.resource_type == resource_type_name  
]  
  
for api_version in api_versions[0]:  
    print(api_version)

Perintah kembali:

2023-05-01
2022-10-01
2022-06-01
2022-01-01
...

Resource Manager didukung di semua wilayah, tetapi sumber daya yang Anda terapkan mungkin tidak didukung di semua wilayah. Selain itu, mungkin ada batasan pada langganan Anda yang mencegah Anda menggunakan beberapa wilayah yang mendukung sumber daya.

Untuk mendapatkan lokasi yang didukung untuk jenis sumber daya, gunakan:

# Get resource provider by ProviderNamespace  
provider_namespace = "Microsoft.Batch"  
provider = resource_management_client.providers.get(provider_namespace)  
  
# Filter resource type by ResourceTypeName and get its Locations  
resource_type_name = "batchAccounts"  
locations = [  
    resource_type.locations  
    for resource_type in provider.resource_types  
    if resource_type.resource_type == resource_type_name  
]  
  
for location in locations[0]:  
    print(location)

Perintah kembali:

West Europe
East US
East US 2
West US
...

Langkah berikutnya