Resursproviders och resurstyper i Azure

När du distribuerar resurser behöver du ofta hämta information om resursproviders och resurstyper. Om du till exempel vill lagra nycklar och hemligheter arbetar du med resursprovidern Microsoft.KeyVault. Den här resursprovidern erbjuder en resurstyp som heter vaults (valv) för att skapa nyckelvalvet.

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 resursproviders 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 göra dessa steg via Azure Portal, Azure PowerShell eller Azure CLI.

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

Registrera resursprovider

Innan du använder en resursprovider måste din Azure-prenumeration vara registrerad 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 de minsta behörigheterna i din prenumeration. En obehörig användare kan inte använda resursproviders som inte är registrerade.

Vissa resursproviders registreras som standard. En lista över resursproviders som är registrerade som standard finns i Resursproviders för Azure-tjänster.

Andra resursproviders registreras automatiskt när du vidta vissa åtgärder. När du skapar en resurs via portalen registreras vanligtvis resursprovidern åt dig. När du distribuerar Azure Resource Manager mall eller Bicep-fil registreras resursproviders 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 resursproviders manuellt.

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

Viktigt

Programkoden ska inte blockera skapandet av resurser för en resursprovider som är i registrering. 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. Om du inte blockerar en resursprovider i registeringstillstå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 gö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 Portal

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 det bland 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 resursproviders

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

    registrera resursproviders

Viktigt

Som tidigare nämnts ska du inte blockera skapandet av resurser för en resursprovider som är i registrering. Om du inte blockerar en resursprovider i registeringstillstå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 resursutforskaren och väljer sedan Resursutforskaren.

    välj Alla tjänster

  4. Expandera Providers (Leverantörer) genom att välja högerpilen.

    Välj leverantörer

  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. Eftersom en resursprovider aktiverar nya funktioner, släpper den en ny version av REST API. Resursutforskaren visar giltiga API-versioner för resurstypen.

    Visa API-versioner

Azure PowerShell

Om du vill se alla resursproviders i Azure och registreringsstatus 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 resursproviders 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 behörighet i din prenumeration registrerar du bara de resursproviders som du är redo att använda. Om du vill registrera en resursprovider använder du:

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ämnts ska du inte blockera skapandet av resurser för en resursprovider som är i registrering. Om du inte blockerar en resursprovider i registeringstillstå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. Eftersom en resursprovider aktiverar nya funktioner, släpper den en ny version av REST API.

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.

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

((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 resursproviders i Azure och registreringsstatus 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 resursproviders 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 behörighet i din prenumeration registrerar du bara de resursproviders som du är redo att använda. Om du vill registrera en resursprovider använder du:

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ämnts ska du inte blockera skapandet av resurser för en resursprovider som är i registrering. Om du inte blockerar en resursprovider i registeringstillstå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. Eftersom en resursprovider aktiverar nya funktioner, släpper den en ny version av REST API.

Om du vill hämta tillgängliga API-versioner 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