Azure-beli erőforrás-szolgáltatók és -típusok

Az Azure-erőforrás-szolgáltató olyan REST-műveletek készlete, amelyek egy adott Azure-szolgáltatás funkcióit teszik lehetővé. A Key Vault szolgáltatás például egy Microsoft.KeyVault nevű erőforrás-szolgáltatóból áll. Az erőforrás-szolgáltató rest-műveleteket határoz meg a tárolók, titkos kódok, kulcsok és tanúsítványok kezeléséhez.

Az erőforrás-szolgáltató határozza meg a fiókban üzembe helyezhető Azure-erőforrásokat. Az erőforrástípus neve a következő formátumot követi: {resource-provider}/{resource-type}. A kulcstartók erőforrástípusa a Microsoft.KeyVault/vaults.

Ebben a cikkben az alábbiakkal ismerkedhet meg:

  • Az összes erőforrás-szolgáltató megtekintése az Azure-ban
  • Erőforrás-szolgáltató regisztrációs állapotának ellenőrzése
  • Erőforrás-szolgáltató regisztrálása
  • Erőforrás-szolgáltató erőforrástípusainak megtekintése
  • Erőforrástípus érvényes helyeinek megtekintése
  • Erőforrástípus érvényes API-verzióinak megtekintése

Az erőforrás-szolgáltatók Azure-szolgáltatásokhoz való leképezéséhez tekintse meg az Azure-szolgáltatások erőforrás-szolgáltatóinak listáját.

Register resource provider

Erőforrás-szolgáltató használata előtt győződjön meg arról, hogy az Azure-előfizetés regisztrálva van az erőforrás-szolgáltatóhoz. A regisztráció úgy konfigurálja az előfizetést, hogy működjön az erőforrás-szolgáltatóval.

Fontos

Erőforrás-szolgáltatót csak akkor regisztrálhat, ha készen áll a használatára. Ez a regisztrációs lépés segít fenntartani a minimális jogosultságokat az előfizetésen belül. A rosszindulatú felhasználók nem használhatnak nem regisztrált erőforrás-szolgáltatókat.

A szükségtelen erőforrás-szolgáltatók regisztrálása azt eredményezheti, hogy ismeretlen alkalmazások jelennek meg a Microsoft Entra-bérlőben. A Microsoft hozzáadja az alkalmazást egy erőforrás-szolgáltatóhoz, amikor regisztrálja. Ezeket az alkalmazásokat általában a Windows Azure Service Management API használja. A bérlő szükségtelen alkalmazásainak megakadályozása érdekében csak a szükséges erőforrás-szolgáltatókat regisztrálja.

Egyes erőforrás-szolgáltatók alapértelmezés szerint regisztrálva vannak. Az alapértelmezés szerint regisztrált erőforrás-szolgáltatók listájáért tekintse meg az Azure-szolgáltatások erőforrás-szolgáltatóinak listáját.

Bizonyos műveletek végrehajtásakor a rendszer automatikusan regisztrálja a többi erőforrás-szolgáltatót. Amikor létrehoz egy erőforrást a portálon keresztül, az erőforrás-szolgáltató általában regisztrálva lesz Az Ön számára. Azure Resource Manager-sablon vagy Bicep-fájl üzembe helyezésekor a rendszer automatikusan regisztrálja a sablonban definiált erőforrás-szolgáltatókat. Előfordulhat, hogy a sablonban lévő erőforrások olyan támogató erőforrásokat igényelnek, amelyek nem szerepelnek a sablonban. Ilyenek például a figyelési vagy biztonsági erőforrások. Ezeket az erőforrás-szolgáltatókat manuálisan kell regisztrálnia.

Más esetekben előfordulhat, hogy manuálisan kell regisztrálnia egy erőforrás-szolgáltatót.

Fontos

Az alkalmazáskód nem tilthatja le a regisztrációs állapotban lévő erőforrás-szolgáltató erőforrásainak létrehozását. Az erőforrás-szolgáltató regisztrálásakor a művelet minden támogatott régióban külön-külön történik. Ha erőforrásokat szeretne létrehozni egy régióban, a regisztrációt csak abban a régióban kell elvégezni. Ha nem blokkolja az erőforrás-szolgáltatót a regisztrációs állapotban, az alkalmazás sokkal hamarabb folytatódhat, mint az összes régió befejezésére várva.

Rendelkeznie kell az erőforrás-szolgáltató műveletének végrehajtásához /register/action szükséges engedéllyel. Az engedély szerepel a közreműködői és tulajdonosi szerepkörökben.

Nem szüntetheti meg az erőforrás-szolgáltató regisztrációját, ha az előfizetésében továbbra is vannak erőforrástípusok az adott erőforrás-szolgáltatótól.

Erőforrás-szolgáltató újraregisztrálása, ha az erőforrás-szolgáltató támogatja a használni kívánt új helyeket.

Azure Portal

Register resource provider

Az erőforrás-szolgáltatók és az előfizetése regisztrációs állapotának megtekintése:

  1. Jelentkezzen be az Azure Portalra.

  2. Az Azure Portal menüjében keressen rá az Előfizetések kifejezésre. Select it from the available options.

    Screenshot of searching for subscriptions in the Azure portal.

  3. Válassza ki a megtekinteni kívánt előfizetést.

    Screenshot of selecting a subscription in the Azure portal.

  4. A bal oldali menü Beállítások területén válassza az Erőforrás-szolgáltatók lehetőséget.

    Screenshot of selecting resource providers in the Azure portal.

  5. Keresse meg a regisztrálni kívánt erőforrás-szolgáltatót, és válassza a Regisztráció lehetőséget. Az előfizetés legkisebb jogosultságainak fenntartása érdekében csak azokat az erőforrás-szolgáltatókat regisztrálja, amelyeket készen áll használni.

    Screenshot of registering a resource provider in the Azure portal.

    Fontos

    Ahogyan korábban említettük, ne tiltsa le az erőforrások létrehozását a regisztrációs állapotban lévő erőforrás-szolgáltató számára. Ha nem blokkolja az erőforrás-szolgáltatót a regisztrációs állapotban, az alkalmazás sokkal hamarabb folytatódhat, mint az összes régió befejezésére várva.

  6. Regisztráljon újra egy erőforrás-szolgáltatót az előző regisztráció óta hozzáadott helyek használatára.

    Screenshot of reregistering a resource provider in the Azure portal.

Erőforrás-szolgáltató megtekintése

Egy adott erőforrás-szolgáltató adatainak megtekintése:

  1. Jelentkezzen be az Azure Portalra.

  2. Az Azure Portal menüjében válassza a Minden szolgáltatás lehetőséget.

  3. A Minden szolgáltatás mezőbe írja be az Erőforrás-kezelőt, majd válassza az Erőforrás-kezelő lehetőséget.

    Screenshot of selecting All services in the Azure portal to access Resource Explorer.

  4. Bontsa ki a Szolgáltatók elemet a jobb nyílra kattintva.

    Screenshot of expanding the Providers section in the Azure Resource Explorer.

  5. Bontsa ki a megtekinteni kívánt erőforrás-szolgáltatót és erőforrástípust.

    Screenshot of expanding a resource provider and resource type in the Azure Resource Explorer.

  6. A Resource Manager minden régióban támogatott, de előfordulhat, hogy a telepített erőforrások nem minden régióban támogatottak. Emellett előfordulhatnak olyan korlátozások az előfizetésben, amelyek megakadályozzák, hogy az erőforrást támogató régiókat használjon. Az erőforrás-kezelő érvényes helyeket jelenít meg az erőforrástípushoz.

    Screenshot of displaying valid locations for a resource type in the Azure Resource Explorer.

  7. Az API-verzió az erőforrás-szolgáltató REST API-műveleteinek egy verziójának felel meg. Mivel az erőforrás-szolgáltató új funkciókat tesz lehetővé, a REST API új verzióját adja ki. Az erőforrás-kezelő az erőforrástípus érvényes API-verzióit jeleníti meg.

    Screenshot of displaying valid API versions for a resource type in the Azure Resource Explorer.

Azure PowerShell

Az azure-beli összes erőforrás-szolgáltató és az előfizetés regisztrációs állapotának megtekintéséhez használja a következőt:

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

A parancs a következőt adja vissza:

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

Az előfizetéshez tartozó összes regisztrált erőforrás-szolgáltató megtekintéséhez használja a következőt:

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

Az előfizetés legkisebb jogosultságainak fenntartása érdekében csak azokat az erőforrás-szolgáltatókat regisztrálja, amelyeket készen áll használni. Erőforrás-szolgáltató regisztrálásához használja a következőt:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

A parancs a következőt adja vissza:

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

Fontos

Ahogyan korábban említettük, ne tiltsa le az erőforrások létrehozását a regisztrációs állapotban lévő erőforrás-szolgáltató számára. Ha nem blokkolja az erőforrás-szolgáltatót a regisztrációs állapotban, az alkalmazás sokkal hamarabb folytatódhat, mint az összes régió befejezésére várva.

Regisztráljon újra egy erőforrás-szolgáltatót az előző regisztráció óta hozzáadott helyek használatára. Az újraregisztrációhoz futtassa újra a regisztrációs parancsot.

Egy adott erőforrás-szolgáltató adatainak megtekintéséhez használja a következőt:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

A parancs a következőt adja vissza:

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

...

Az erőforrás-szolgáltató erőforrástípusainak megtekintéséhez használja a következőt:

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

A parancs a következőt adja vissza:

batchAccounts
operations
locations
locations/quotas

Az API-verzió az erőforrás-szolgáltató REST API-műveleteinek egy verziójának felel meg. Mivel az erőforrás-szolgáltató új funkciókat tesz lehetővé, a REST API új verzióját adja ki.

Az erőforrástípushoz elérhető API-verziók beszerzéséhez használja a következőt:

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

A parancs a következőt adja vissza:

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

A Resource Manager minden régióban támogatott, de előfordulhat, hogy a telepített erőforrások nem minden régióban támogatottak. Emellett előfordulhatnak olyan korlátozások az előfizetésben, amelyek megakadályozzák, hogy az erőforrást támogató régiókat használjon.

Az erőforrástípus támogatott helyeinek lekéréséhez használja a következőt:

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

A parancs a következőt adja vissza:

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

Azure CLI

Az azure-beli összes erőforrás-szolgáltató és az előfizetés regisztrációs állapotának megtekintéséhez használja a következőt:

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

A parancs a következőt adja vissza:

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

Az előfizetéshez tartozó összes regisztrált erőforrás-szolgáltató megtekintéséhez használja a következőt:

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

Az előfizetés legkisebb jogosultságainak fenntartása érdekében csak azokat az erőforrás-szolgáltatókat regisztrálja, amelyeket készen áll használni. Erőforrás-szolgáltató regisztrálásához használja a következőt:

az provider register --namespace Microsoft.Batch

A parancs egy üzenetet ad vissza, amely szerint a regisztráció folyamatban van.

Egy adott erőforrás-szolgáltató adatainak megtekintéséhez használja a következőt:

az provider show --namespace Microsoft.Batch

A parancs a következőt adja vissza:

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

Fontos

Ahogyan korábban említettük, ne tiltsa le az erőforrások létrehozását a regisztrációs állapotban lévő erőforrás-szolgáltató számára. Ha nem blokkolja az erőforrás-szolgáltatót a regisztrációs állapotban, az alkalmazás sokkal hamarabb folytatódhat, mint az összes régió befejezésére várva.

Az erőforrás-szolgáltató erőforrástípusainak megtekintéséhez használja a következőt:

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

A parancs a következőt adja vissza:

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

Az API-verzió az erőforrás-szolgáltató REST API-műveleteinek egy verziójának felel meg. Mivel az erőforrás-szolgáltató új funkciókat tesz lehetővé, a REST API új verzióját adja ki.

Az erőforrástípushoz elérhető API-verziók beszerzéséhez használja a következőt:

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

A parancs a következőt adja vissza:

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

A Resource Manager minden régióban támogatott, de előfordulhat, hogy a telepített erőforrások nem minden régióban támogatottak. Emellett előfordulhatnak olyan korlátozások az előfizetésben, amelyek megakadályozzák, hogy az erőforrást támogató régiókat használjon.

Az erőforrástípus támogatott helyeinek lekéréséhez használja a következőt:

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

A parancs a következőt adja vissza:

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

Python

Az azure-beli összes erőforrás-szolgáltató és az előfizetés regisztrációs állapotának megtekintéséhez használja a következőt:

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}")  

A parancs a következőt adja vissza:

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
...

Az előfizetéshez tartozó összes regisztrált erőforrás-szolgáltató megtekintéséhez használja a következőt:

# 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}")  

Az előfizetés legkisebb jogosultságainak fenntartása érdekében csak azokat az erőforrás-szolgáltatókat regisztrálja, amelyeket készen áll használni. Erőforrás-szolgáltató regisztrálásához használja a következőt:

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}")  

A parancs a következőt adja vissza:

ProviderNamespace: Microsoft.Batch, RegistrationState: Registered

Fontos

Ahogyan korábban említettük, ne tiltsa le az erőforrások létrehozását a regisztrációs állapotban lévő erőforrás-szolgáltató számára. Ha nem blokkolja az erőforrás-szolgáltatót a regisztrációs állapotban, az alkalmazás sokkal hamarabb folytatódhat, mint az összes régió befejezésére várva.

Regisztráljon újra egy erőforrás-szolgáltatót az előző regisztráció óta hozzáadott helyek használatára. Az újraregisztrációhoz futtassa újra a regisztrációs parancsot.

Egy adott erőforrás-szolgáltató adatainak megtekintéséhez használja a következőt:

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")  

A parancs a következőt adja vissza:

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

...

Az erőforrás-szolgáltató erőforrástípusainak megtekintéséhez használja a következőt:

# 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)  

A parancs a következőt adja vissza:

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

Az API-verzió az erőforrás-szolgáltató REST API-műveleteinek egy verziójának felel meg. Mivel az erőforrás-szolgáltató új funkciókat tesz lehetővé, a REST API új verzióját adja ki.

Az erőforrástípushoz elérhető API-verziók beszerzéséhez használja a következőt:

# 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)  

A parancs a következőt adja vissza:

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

A Resource Manager minden régióban támogatott, de előfordulhat, hogy a telepített erőforrások nem minden régióban támogatottak. Emellett előfordulhatnak olyan korlátozások az előfizetésben, amelyek megakadályozzák, hogy az erőforrást támogató régiókat használjon.

Az erőforrástípus támogatott helyeinek lekéréséhez használja a következőt:

# 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)  

A parancs a következőt adja vissza:

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

Következő lépések

  • A Resource Manager-sablonok létrehozásáról az Azure Resource Manager-sablonok készítése című témakörben olvashat.
  • Az erőforrás-szolgáltató sablonsémainak megtekintéséhez tekintse meg a sablonreferenciát.
  • Az erőforrás-szolgáltatók Azure-szolgáltatásokhoz való leképezéséhez tekintse meg az Azure-szolgáltatások erőforrás-szolgáltatóinak listáját.
  • Az erőforrás-szolgáltató műveleteinek megtekintéséhez tekintse meg az Azure REST API-t.