Poskytovatelé a typy prostředků Azure

Poskytovatel prostředků Azure je kolekce operací REST, které poskytují funkce pro službu Azure. Služba Key Vault se například skládá z poskytovatele prostředků s názvem Microsoft.KeyVault. Poskytovatel prostředků definuje operace REST pro práci s trezory, tajnými kódy, klíči a certifikáty.

Poskytovatel prostředků definuje prostředky Azure, které jsou k dispozici pro nasazení do vašeho účtu. Název typu prostředku má formát: {poskytovatel prostředku}/{typ prostředku}. Typ prostředku trezoru klíčů je Microsoft.KeyVault/vaults.

V tomto článku získáte informace o těchto tématech:

  • Zobrazení všech poskytovatelů prostředků v Azure
  • Kontrola stavu registrace poskytovatele prostředků
  • Registrace poskytovatele prostředků
  • Zobrazení typů prostředků pro poskytovatele prostředků
  • Zobrazení platných umístění pro typ prostředku
  • Zobrazení platných verzí rozhraní API pro typ prostředku

Tyto kroky můžete provést prostřednictvím Azure Portal, Azure PowerShell nebo Azure CLI.

Seznam, který mapuje poskytovatele prostředků na služby Azure, najdete v tématu Poskytovatelé prostředků pro služby Azure.

Registrace poskytovatele prostředků

Před použitím poskytovatele prostředků musí být vaše předplatné Azure zaregistrované pro poskytovatele prostředků. Registrace nakonfiguruje vaše předplatné tak, aby fungovalo s poskytovatelem prostředků.

Důležité

Zaregistrujte poskytovatele prostředků jenom v případě, že jste připraveni ho použít. Krok registrace umožňuje udržovat nejnižší oprávnění ve vašem předplatném. Uživatel se zlými úmysly nemůže používat poskytovatele prostředků, kteří nejsou zaregistrovaní.

Někteří poskytovatelé prostředků jsou ve výchozím nastavení zaregistrovaní. Seznam poskytovatelů prostředků zaregistrovaných ve výchozím nastavení najdete v tématu Poskytovatelé prostředků pro služby Azure.

Ostatní poskytovatelé prostředků se automaticky zaregistrují, když provedete určité akce. Když vytvoříte prostředek prostřednictvím portálu, poskytovatel prostředků se obvykle zaregistruje za vás. Když nasadíte šablonu Azure Resource Manager nebo soubor Bicep, zprostředkovatelé prostředků definované v šabloně se automaticky zaregistrují. Pokud ale prostředek v šabloně vytváří podpůrné prostředky, které nejsou v šabloně, například monitorování nebo prostředky zabezpečení, musíte tyto poskytovatele prostředků zaregistrovat ručně.

V jiných scénářích možná budete muset ručně zaregistrovat poskytovatele prostředků.

Důležité

Kód aplikace by neměl blokovat vytváření prostředků pro poskytovatele prostředků, který je ve stavu registrace . Při registraci poskytovatele prostředků se operace provádí jednotlivě pro každou podporovanou oblast. Pokud chcete vytvořit prostředky v oblasti, musí být registrace dokončena pouze v této oblasti. Tím, že neblokujete poskytovatele prostředků ve stavu registrace, může vaše aplikace pokračovat mnohem dříve, než čeká na dokončení všech oblastí.

Musíte mít oprávnění k provedení /register/action operace pro poskytovatele prostředků. Oprávnění je součástí rolí Přispěvatel a Vlastník.

Pokud v předplatném stále máte typy prostředků od daného poskytovatele prostředků, nemůžete zrušit registraci poskytovatele prostředků.

portál Azure

Registrace poskytovatele prostředků

Pokud chcete zobrazit všechny poskytovatele prostředků a stav jejich registrace pro vaše předplatné:

  1. Přihlaste se k webu Azure Portal.

  2. V nabídce webu Azure Portal vyhledejte Předplatná. Vyberte ji z dostupných možností.

    vyhledávání předplatných

  3. Vyberte předplatné, které chcete zobrazit.

    vybrat předplatná

  4. V nabídce vlevo v části Nastavení vyberte Poskytovatelé prostředků.

    výběr poskytovatelů prostředků

  5. Najděte poskytovatele prostředků, kterého chcete zaregistrovat, a vyberte Zaregistrovat. Pokud chcete zachovat nejnižší oprávnění ve vašem předplatném, zaregistrujte jenom ty poskytovatele prostředků, které jste připraveni použít.

    registrace poskytovatelů prostředků

Důležité

Jak jsme si poznamenali dříve, neblokujte vytváření prostředků pro poskytovatele prostředků, který je ve stavu registrace . Tím, že neblokujete poskytovatele prostředků ve stavu registrace, může vaše aplikace pokračovat mnohem dříve, než čeká na dokončení všech oblastí.

Zobrazení poskytovatele prostředků

Zobrazení informací pro konkrétního poskytovatele prostředků:

  1. Přihlaste se na web Azure Portal.

  2. V nabídce webu Azure Portal vyberte Všechny služby.

  3. Do pole Všechny služby zadejte Průzkumníka prostředků a pak vyberte Průzkumník prostředků.

    vyberte Všechny služby.

  4. Rozbalte zprostředkovatele tak, že vyberete šipku vpravo.

    Výběr poskytovatelů

  5. Rozbalte poskytovatele prostředků a typ prostředku, který chcete zobrazit.

    Vybrat typ prostředku

  6. Resource Manager se podporuje ve všech oblastech, ale prostředky, které nasazujete, nemusí být podporované ve všech oblastech. U vašeho předplatného můžou být také omezení, která vám brání v používání některých oblastí, které tento prostředek podporují. Průzkumník prostředků zobrazí platná umístění pro typ prostředku.

    Zobrazit umístění

  7. Verze rozhraní API odpovídá verzi operací REST API vydaných poskytovatelem prostředků. Jako poskytovatel prostředků umožňuje nové funkce, vydává novou verzi rozhraní REST API. Průzkumník prostředků zobrazí platné verze rozhraní API pro typ prostředku.

    Zobrazit verze rozhraní API

Azure PowerShell

Pokud chcete zobrazit všechny poskytovatele prostředků v Azure a stav registrace pro vaše předplatné, použijte:

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

Příkaz vrátí:

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

Pokud chcete zobrazit všechny registrované poskytovatele prostředků pro vaše předplatné, použijte:

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

Pokud chcete zachovat nejnižší oprávnění ve vašem předplatném, zaregistrujte jenom ty poskytovatele prostředků, které jste připraveni použít. Pokud chcete zaregistrovat poskytovatele prostředků, použijte:

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

Příkaz vrátí:

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

Důležité

Jak jsme si poznamenali dříve, neblokujte vytváření prostředků pro poskytovatele prostředků, který je ve stavu registrace . Tím, že neblokujete poskytovatele prostředků ve stavu registrace, může vaše aplikace pokračovat mnohem dříve, než čeká na dokončení všech oblastí.

Pokud chcete zobrazit informace pro konkrétního poskytovatele prostředků, použijte:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

Příkaz vrátí:

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

...

Pokud chcete zobrazit typy prostředků pro poskytovatele prostředků, použijte:

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

Příkaz vrátí:

batchAccounts
operations
locations
locations/quotas

Verze rozhraní API odpovídá verzi operací REST API vydaných poskytovatelem prostředků. Jako poskytovatel prostředků umožňuje nové funkce, vydává novou verzi rozhraní REST API.

Pokud chcete získat dostupné verze rozhraní API pro typ prostředku, použijte:

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

Příkaz vrátí:

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

Resource Manager se podporuje ve všech oblastech, ale prostředky, které nasazujete, nemusí být podporované ve všech oblastech. U vašeho předplatného můžou být také omezení, která vám brání v používání některých oblastí, které tento prostředek podporují.

Pokud chcete získat podporovaná umístění pro typ prostředku, použijte.

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

Příkaz vrátí:

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

Azure CLI

Pokud chcete zobrazit všechny poskytovatele prostředků v Azure a stav registrace pro vaše předplatné, použijte:

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

Příkaz vrátí:

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

Pokud chcete zobrazit všechny registrované poskytovatele prostředků pro vaše předplatné, použijte:

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

Pokud chcete zachovat nejnižší oprávnění ve vašem předplatném, zaregistrujte jenom ty poskytovatele prostředků, které jste připraveni použít. Pokud chcete zaregistrovat poskytovatele prostředků, použijte:

az provider register --namespace Microsoft.Batch

Příkaz vrátí zprávu, že registrace probíhá.

Pokud chcete zobrazit informace pro konkrétního poskytovatele prostředků, použijte:

az provider show --namespace Microsoft.Batch

Příkaz vrátí:

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

Důležité

Jak jsme si poznamenali dříve, neblokujte vytváření prostředků pro poskytovatele prostředků, který je ve stavu registrace . Tím, že neblokujete poskytovatele prostředků ve stavu registrace, může vaše aplikace pokračovat mnohem dříve, než čeká na dokončení všech oblastí.

Pokud chcete zobrazit typy prostředků pro poskytovatele prostředků, použijte:

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

Příkaz vrátí:

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

Verze rozhraní API odpovídá verzi operací REST API vydaných poskytovatelem prostředků. Jako poskytovatel prostředků umožňuje nové funkce, vydává novou verzi rozhraní REST API.

Pokud chcete získat dostupné verze rozhraní API pro typ prostředku, použijte:

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

Příkaz vrátí:

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

Resource Manager se podporuje ve všech oblastech, ale prostředky, které nasazujete, nemusí být podporované ve všech oblastech. U vašeho předplatného můžou být také omezení, která vám brání v používání některých oblastí, které tento prostředek podporují.

Pokud chcete získat podporovaná umístění pro typ prostředku, použijte.

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

Příkaz vrátí:

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

Další kroky