Poskytovatelé a typy prostředků Azure

Při nasazování prostředků často potřebujete načíst informace o poskytovatelích a typech prostředků. Pokud například chcete ukládat klíče a tajné klíče, využijete poskytovatele prostředků Microsoft.KeyVault. Tento poskytovatel prostředků nabízí typ prostředků nazvaný trezory pro vytvoření trezoru klíčů.

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:

  • Zobrazit vše 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 následujících 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é

Poskytovatele prostředků zaregistrujte pouze v případě, že jste připraveni ho použít. Krok registrace umožňuje udržovat v rámci vašeho předplatného co nejmenší oprávnění. 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 při určitých akcích automaticky zaregistrovali. Když vytvoříte prostředek prostřednictvím portálu, poskytovatel prostředků je obvykle zaregistrovaný za vás. Když nasadíte Azure Resource Manager nebo soubor Bicep, poskytovatelé prostředků definovaní v šabloně se automaticky zaregistrovali. Pokud ale prostředek v šabloně vytvoří podpůrné prostředky, které nejsou v šabloně, například prostředky monitorování nebo zabezpečení, musíte tyto poskytovatele prostředků zaregistrovat ručně.

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

Důležité

Kód vaší 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, je potřeba registraci dokončit pouze v této oblasti. Tím, že neblokuje poskytovatele prostředků ve stavu registrace, může vaše aplikace pokračovat mnohem dříve než čekat na dokončení všech oblastí.

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

Pokud ve svém předplatném stále máte typy prostředků od tohoto 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 ho z dostupných možností.

    vyhledávání předplatných

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

    výběr předplatných

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

    Výběr poskytovatelů prostředků

  5. Vyhledejte poskytovatele prostředků, kterého chcete zaregistrovat, a vyberte Zaregistrovat. Pokud chcete ve svém předplatném zachovat co nejmenší oprávnění, zaregistrujte pouze poskytovatele prostředků, které jste připraveni použít.

    registrace poskytovatelů prostředků

Důležité

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

Zobrazení poskytovatele prostředků

Zobrazení informací o konkrétním poskytovateli 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ík prostředků a pak vyberte Průzkumník prostředků.

    Výběr možnosti Všechny služby

  4. Výběrem šipky doprava rozbalte Poskytovatelé.

    Výběr zprostředkovatelů

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

    Výběr typu prostředku

  6. Resource Manager se podporuje ve všech oblastech, ale prostředky, které nasadíte, nemusí být podporované ve všech oblastech. Vaše předplatné může mít také určitá 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.

    Zobrazení umístění

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

    Zobrazení verzí rozhraní API

Azure PowerShell

Pokud chcete zobrazit všechny poskytovatele prostředků v Azure a stav registrace vašeho předplatného, 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 zaregistrované 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 ve svém předplatném zachovat co nejmenší oprávnění, zaregistrujte pouze poskytovatele prostředků, které jste připraveni použít. K registraci 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 uvedli dříve, neblokujte vytváření prostředků pro poskytovatele prostředků, který je ve stavu registrace. Tím, že neblokuje poskytovatele prostředků ve stavu registrace, může vaše aplikace pokračovat mnohem dříve než čekat na dokončení všech oblastí.

Pokud chcete zobrazit informace o konkrétním poskytovateli 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 REST API operací vydaných poskytovatelem prostředků. Poskytovatel prostředků umožňuje nové funkce, a proto vydává novou verzi 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é nasadíte, nemusí být podporované ve všech oblastech. Vaše předplatné může mít také určitá 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 vašeho předplatného, 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 zaregistrované 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 ve svém předplatném zachovat co nejmenší oprávnění, zaregistrujte pouze poskytovatele prostředků, které jste připraveni použít. K registraci poskytovatele prostředků použijte:

az provider register --namespace Microsoft.Batch

Příkaz vrátí zprávu, že registrace je v procesu.

Pokud chcete zobrazit informace o konkrétním poskytovateli 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 bylo uvedeno dříve, neblokuje vytváření prostředků pro poskytovatele prostředků, který je ve stavu registrace . Neblokuje poskytovatele prostředků ve stavu registrace, takže aplikace může pokračovat mnohem dřív než čekání na dokončení všech oblastí.

Chcete-li 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 REST API operací, které jsou vydány poskytovatelem prostředků. V případě, že poskytovatel prostředků poskytuje nové funkce, uvolňuje novou verzi REST API.

K získání dostupných verzí 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

Správce prostředků se podporují ve všech oblastech, ale prostředky, které nasadíte, nemusí být podporované ve všech oblastech. U předplatného může být taky omezení, která vám zabrání v používání některých oblastí, které podporují daný prostředek.

Chcete-li 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