Resursproviders och resurstyper i Azure

En Azure-resursprovider är en samling REST-åtgärder som tillhandahåller funktioner för en Azure-tjänst. Till exempel består 密钥保管库-tjänsten av en resursprovider med namnet Microsoft. KeyVault. Resursprovidern definierar REST-åtgärder för att arbeta med valv, hemligheter, nycklar och certifikat.

Resursprovidern definierar de Azure-resurser som är tillgängliga för distribution till ditt konto. Namnet på en resurstyp skrivs i formatet: {resursprovidern}/{resurstypen}. Resurstypen för ett nyckelvalv är Microsoft.KeyVault\vaults.

I den här artikeln kan du se hur du:

  • Visa alla resursprovidrar i Azure
  • Kontrollera registreringsstatus för en resursprovider
  • Registrera en resursprovider
  • Visa resurstyper för en resursprovider
  • Visa giltiga platser för en resurstyp
  • Visa giltiga API-versioner för en resurstyp

Du kan utföra de här stegen via Azure-Portal, Azure PowerShell eller Azure CLI.

En lista som mappar resursprovidrar till Azure-tjänster finns i Resursprovidrar för Azure-tjänster.

Registrera resursprovider

Innan du använder en resursprovider måste din Azure-prenumeration registreras för resursprovidern. Registreringen konfigurerar din prenumeration så att den fungerar med resursprovidern.

Viktigt

Registrera bara en resursprovider när du är redo att använda den. Med registreringssteget kan du behålla minsta möjliga behörighet i din prenumeration. En obehörig användare kan inte använda resursproviders som inte är registrerade.

Vissa resursprovidrar är registrerade som standard. En lista över resursprovidrar som är registrerade som standard finns i Resursprovidrar för Azure-tjänster.

Andra resursproviders registreras automatiskt när du vidtar vissa åtgärder. När du skapar en resurs via portalen registreras vanligtvis resursprovidern åt dig. När du distribuerar en Azure Resource Manager-mall eller Bicep-fil registreras resursprovidrar som definierats i mallen automatiskt. Men om en resurs i mallen skapar stödresurser som inte finns i mallen, till exempel övervaknings- eller säkerhetsresurser, måste du registrera dessa resursprovidrar manuellt.

I andra scenarier kan du behöva registrera en resursprovider manuellt.

Viktigt

Programkoden bör inte blockera skapandet av resurser för en resursprovider som är i registreringstillstånd . När du registrerar resursprovidern utförs åtgärden individuellt för varje region som stöds. Om du vill skapa resurser i en region behöver registreringen bara slutföras i den regionen. Genom att inte blockera en resursprovider i registreringstillståndet kan programmet fortsätta mycket tidigare än att vänta på att alla regioner ska slutföras.

Du måste ha behörighet att utföra /register/action åtgärden för resursprovidern. Behörigheten ingår i rollerna Deltagare och Ägare.

Du kan inte avregistrera en resursprovider när du fortfarande har resurstyper från den resursprovidern i din prenumeration.

Azure-portalen

Registrera resursprovider

Så här visar du alla resursprovidrar och registreringsstatusen för din prenumeration:

  1. Logga in på Azure-portalen.

  2. På Azure-portalens meny söker du efter Prenumerationer. Välj från de tillgängliga alternativen.

    sökprenumerationer

  3. Välj den prenumeration som du vill visa.

    välj prenumerationer

  4. På menyn till vänster går du till Inställningar och väljer Resursprovidrar.

    välj resursprovidrar

  5. Leta upp den resursprovider som du vill registrera och välj Registrera. Om du vill behålla minsta möjliga behörighet i din prenumeration registrerar du bara de resursprovidrar som du är redo att använda.

    registrera resursprovidrar

Viktigt

Som tidigare nämntsska du inte blockera skapandet av resurser för en resursprovider som är i registreringstillståndet . Genom att inte blockera en resursprovider i registreringstillståndet kan programmet fortsätta mycket tidigare än att vänta på att alla regioner ska slutföras.

Visa resursprovider

Så här ser du information för en viss resursprovider:

  1. Logga in på Azure-portalen.

  2. Välj Alla tjänster på menyn i Azure-portalen.

  3. I rutan Alla tjänster anger du Resursläsaren och väljer sedan Resursläsaren.

    välj Alla tjänster

  4. Expandera Providers genom att välja högerpilen.

    Välj providrar

  5. Expandera en resursprovider och resurstyp som du vill visa.

    Välj resurstyp

  6. Resource Manager stöds i alla regioner, men de resurser som du distribuerar kanske inte stöds i alla regioner. Det kan också finnas begränsningar för din prenumeration som hindrar dig från att använda vissa regioner som stöder resursen. Resursutforskaren visar giltiga platser för resurstypen.

    Visa platser

  7. API-versionen motsvarar en version av REST API-åtgärder som släpps av resursprovidern. När en resursprovider aktiverar nya funktioner släpper den en ny version av REST-API:et. Resursutforskaren visar giltiga API-versioner för resurstypen.

    Visa API-versioner

Azure PowerShell

Om du vill se alla resursprovidrar i Azure och registreringsstatusen för din prenumeration använder du:

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

Kommandot returnerar:

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

Om du vill se alla registrerade resursprovidrar för din prenumeration använder du:

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

Om du vill behålla minsta möjliga behörighet i din prenumeration registrerar du bara de resursprovidrar som du är redo att använda. Så här registrerar du en resursåterförsäljare:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

Kommandot returnerar:

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

Viktigt

Som tidigare nämntsska du inte blockera skapandet av resurser för en resursprovider som är i registreringstillståndet . Genom att inte blockera en resursprovider i registreringstillståndet kan programmet fortsätta mycket tidigare än att vänta på att alla regioner ska slutföras.

Om du vill se information för en viss resursprovider använder du:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

Kommandot returnerar:

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

...

Om du vill se resurstyperna för en resursprovider använder du:

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

Kommandot returnerar:

batchAccounts
operations
locations
locations/quotas

API-versionen motsvarar en version av REST API-åtgärder som släpps av resursprovidern. När en resursprovider aktiverar nya funktioner släpper den en ny version av REST-API:et.

Om du vill hämta tillgängliga API-versioner för en resurstyp använder du:

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

Kommandot returnerar:

2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

Resource Manager stöds i alla regioner, men de resurser som du distribuerar kanske inte stöds i alla regioner. Det kan också finnas begränsningar för din prenumeration som hindrar dig från att använda vissa regioner som stöder resursen.

Använd för att hämta de platser som stöds för en resurstyp.

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

Kommandot returnerar:

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

Azure CLI

Om du vill se alla resursprovidrar i Azure och registreringsstatusen för din prenumeration använder du:

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

Kommandot returnerar:

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

Om du vill se alla registrerade resursprovidrar för din prenumeration använder du:

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

Om du vill behålla minsta möjliga behörighet i din prenumeration registrerar du bara de resursprovidrar som du är redo att använda. Så här registrerar du en resursåterförsäljare:

az provider register --namespace Microsoft.Batch

Kommandot returnerar ett meddelande om att registreringen pågår.

Om du vill se information för en viss resursprovider använder du:

az provider show --namespace Microsoft.Batch

Kommandot returnerar:

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

Viktigt

Som tidigare nämntsska du inte blockera skapandet av resurser för en resursprovider som är i registreringstillståndet . Genom att inte blockera en resursprovider i registreringstillståndet kan programmet fortsätta mycket tidigare än att vänta på att alla regioner ska slutföras.

Om du vill se resurstyperna för en resursprovider använder du:

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

Kommandot returnerar:

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

API-versionen motsvarar en version av REST API-åtgärder som släpps av resursprovidern. När en resursprovider aktiverar nya funktioner släpper den en ny version av REST-API:et.

Om du vill hämta de tillgängliga API-versionerna för en resurstyp använder du:

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

Kommandot returnerar:

Result
---------------
2017-05-01
2017-01-01
2015-12-01
2015-09-01
2015-07-01

Resource Manager stöds i alla regioner, men de resurser som du distribuerar kanske inte stöds i alla regioner. Det kan också finnas begränsningar för din prenumeration som hindrar dig från att använda vissa regioner som stöder resursen.

Om du vill hämta de platser som stöds för en resurstyp använder du.

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

Kommandot returnerar:

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

Nästa steg