Poskytovatelé a typy prostředků AzureAzure resource providers and types

Při nasazování prostředků často potřebujete získat informace o poskytovatelích a typech prostředků.When deploying resources, you frequently need to retrieve information about the resource providers and types. Pokud například chcete ukládat klíče a tajné kódy, budete pracovat s poskytovatelem prostředků Microsoft. datatrezoru.For example, if you want to store keys and secrets, you work with the Microsoft.KeyVault resource provider. Tento poskytovatel prostředků nabízí typ prostředku s názvem trezory pro vytvoření trezoru klíčů.This resource provider offers a resource type called vaults for creating the key vault.

Název typu prostředku má formát: {poskytovatel prostředku}/{typ prostředku} .The name of a resource type is in the format: {resource-provider}/{resource-type}. Typ prostředku pro Trezor klíčů je trezor a trezory společnosti Microsoft.The resource type for a key vault is Microsoft.KeyVault/vaults.

V tomto článku získáte informace o těchto tématech:In this article, you learn how to:

  • Zobrazit všechny poskytovatele prostředků v AzureView all resource providers in Azure
  • Zkontroluje stav registrace poskytovatele prostředků.Check registration status of a resource provider
  • Registrace poskytovatele prostředkůRegister a resource provider
  • Zobrazení typů prostředků pro poskytovatele prostředkůView resource types for a resource provider
  • Zobrazit platná umístění pro typ prostředkuView valid locations for a resource type
  • Zobrazit platné verze rozhraní API pro typ prostředkuView valid API versions for a resource type

Tyto kroky můžete provádět pomocí Azure Portal, Azure PowerShell nebo rozhraní příkazového řádku Azure.You can do these steps through the Azure portal, Azure PowerShell, or Azure CLI.

Seznam, který mapuje poskytovatele prostředků na služby Azure, najdete v tématu poskytovatelé prostředků pro služby Azure.For a list that maps resource providers to Azure services, see Resource providers for Azure services.

Portál AzureAzure portal

Pokud chcete zobrazit všechny poskytovatele prostředků a stav registrace pro vaše předplatné:To see all resource providers, and the registration status for your subscription:

  1. Přihlaste se na web Azure Portal.Sign in to the Azure portal.

  2. V nabídce Azure Portal vyberte všechny služby.On the Azure portal menu, select All services.

    vybrat odběry

  3. V poli všechny služby zadejte předplatnéa pak vyberte předplatná.In the All services box, enter subscription, and then select Subscriptions.

  4. Vyberte předplatné ze seznamu odběrů, které chcete zobrazit.Select the subscription from the subscription list to view.

  5. Vyberte poskytovatele prostředků a zobrazte seznam dostupných poskytovatelů prostředků.Select Resource providers and view the list of available resource providers.

    Zobrazit poskytovatele prostředků

  6. Když zaregistrujete poskytovatele prostředků, nakonfigurujete vaše předplatné, aby fungovalo s poskytovatelem prostředků.Registering a resource provider configures your subscription to work with the resource provider. Obor pro registraci je vždy předplatné.The scope for registration is always the subscription. Ve výchozím nastavení je řada poskytovatelů prostředků zaregistrována automaticky.By default, many resource providers are automatically registered. Je ale možné, že budete muset některé poskytovatele prostředků zaregistrovat ručně.However, you may need to manually register some resource providers. Chcete-li zaregistrovat poskytovatele prostředků, musíte mít oprávnění k provedení operace /register/action pro poskytovatele prostředků.To register a resource provider, you must have permission to do the /register/action operation for the resource provider. Tato operace je součástí rolí Přispěvatel a Vlastník.This operation is included in the Contributor and Owner roles. Chcete-li zaregistrovat poskytovatele prostředků, vyberte možnost Registrovat.To register a resource provider, select Register. Na předchozím snímku obrazovky se zvýrazní odkaz zaregistrovat pro Microsoft. detail.In the previous screenshot, the Register link is highlighted for Microsoft.Blueprint.

    Pokud v předplatném máte typy prostředků od tohoto poskytovatele prostředků, nemůžete zrušit registraci poskytovatele prostředků.You can't unregister a resource provider when you still have resource types from that resource provider in your subscription.

Chcete-li zobrazit informace o konkrétním poskytovateli prostředků:To see information for a particular resource provider:

  1. Přihlaste se na web Azure Portal.Sign in to the Azure portal.

  2. V nabídce Azure Portal vyberte všechny služby.On the Azure portal menu, select All services.

  3. V poli všechny služby zadejte Průzkumník prostředkůa potom vyberte Průzkumník prostředků.In the All services box, enter resource explorer, and then select Resource Explorer.

    vybrat všechny služby

  4. Rozbalte položku poskytovatelé a vyberte šipku doprava.Expand Providers by selecting the right arrow.

    Vybrat poskytovatele

  5. Rozbalte poskytovatele prostředků a typ prostředku, který chcete zobrazit.Expand a resource provider and resource type that you want to view.

    Vybrat typ prostředku

  6. Správce prostředků se podporují ve všech oblastech, ale prostředky, které nasadíte, nemusí být podporované ve všech oblastech.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Kromě toho můžou mít vaše předplatné omezení, které vám brání v používání některých oblastí, které podporují daný prostředek.In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource. Průzkumník prostředků zobrazuje platná umístění pro daný typ prostředku.The resource explorer displays valid locations for the resource type.

    Zobrazit umístění

  7. Verze rozhraní API odpovídá verzi REST API operací, které jsou vydány poskytovatelem prostředků.The API version corresponds to a version of REST API operations that are released by the resource provider. V případě, že poskytovatel prostředků poskytuje nové funkce, uvolňuje novou verzi REST API.As a resource provider enables new features, it releases a new version of the REST API. Průzkumník prostředků zobrazuje platné verze rozhraní API pro daný typ prostředku.The resource explorer displays valid API versions for the resource type.

    Zobrazit verze rozhraní API

Azure PowerShellAzure PowerShell

Poznámka

Tento článek je aktualizovaný a využívá nový modul Az Azure PowerShellu.This article has been updated to use the new Azure PowerShell Az module. Můžete dál využívat modul AzureRM, který bude dostávat opravy chyb nejméně do prosince 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Další informace o kompatibilitě nového modulu Az a modulu AzureRM najdete v tématu Seznámení s novým modulem Az Azure PowerShellu.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Pokyny k instalaci modulu Az najdete v tématu věnovaném instalaci Azure PowerShellu.For Az module installation instructions, see Install Azure PowerShell.

Pokud chcete zobrazit všechny poskytovatele prostředků v Azure a stav registrace pro vaše předplatné, použijte:To see all resource providers in Azure, and the registration status for your subscription, use:

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

Což vrátí výsledek podobný tomuto:Which returns results similar to:

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

Když zaregistrujete poskytovatele prostředků, nakonfigurujete vaše předplatné, aby fungovalo s poskytovatelem prostředků.Registering a resource provider configures your subscription to work with the resource provider. Obor pro registraci je vždy předplatné.The scope for registration is always the subscription. Ve výchozím nastavení je řada poskytovatelů prostředků zaregistrována automaticky.By default, many resource providers are automatically registered. Je ale možné, že budete muset některé poskytovatele prostředků zaregistrovat ručně.However, you may need to manually register some resource providers. Chcete-li zaregistrovat poskytovatele prostředků, musíte mít oprávnění k provedení operace /register/action pro poskytovatele prostředků.To register a resource provider, you must have permission to do the /register/action operation for the resource provider. Tato operace je součástí rolí Přispěvatel a Vlastník.This operation is included in the Contributor and Owner roles.

Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

Což vrátí výsledek podobný tomuto:Which returns results similar to:

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

Pokud v předplatném máte typy prostředků od tohoto poskytovatele prostředků, nemůžete zrušit registraci poskytovatele prostředků.You can't unregister a resource provider when you still have resource types from that resource provider in your subscription.

Pokud chcete zobrazit informace o konkrétním poskytovateli prostředků, použijte:To see information for a particular resource provider, use:

Get-AzResourceProvider -ProviderNamespace Microsoft.Batch

Což vrátí výsledek podobný tomuto:Which returns results similar to:

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

...

Chcete-li zobrazit typy prostředků pro poskytovatele prostředků, použijte:To see the resource types for a resource provider, use:

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

Který vrátí:Which returns:

batchAccounts
operations
locations
locations/quotas

Verze rozhraní API odpovídá verzi REST API operací, které jsou vydány poskytovatelem prostředků.The API version corresponds to a version of REST API operations that are released by the resource provider. V případě, že poskytovatel prostředků poskytuje nové funkce, uvolňuje novou verzi REST API.As a resource provider enables new features, it releases a new version of the REST API.

K získání dostupných verzí rozhraní API pro typ prostředku použijte:To get the available API versions for a resource type, use:

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

Který vrátí:Which returns:

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.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Kromě toho můžou mít vaše předplatné omezení, které vám brání v používání některých oblastí, které podporují daný prostředek.In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource.

Chcete-li získat podporovaná umístění pro typ prostředku, použijte.To get the supported locations for a resource type, use.

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

Který vrátí:Which returns:

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

Azure CLIAzure CLI

Pokud chcete zobrazit všechny poskytovatele prostředků v Azure a stav registrace pro vaše předplatné, použijte:To see all resource providers in Azure, and the registration status for your subscription, use:

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

Což vrátí výsledek podobný tomuto:Which returns results similar to:

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

Když zaregistrujete poskytovatele prostředků, nakonfigurujete vaše předplatné, aby fungovalo s poskytovatelem prostředků.Registering a resource provider configures your subscription to work with the resource provider. Obor pro registraci je vždy předplatné.The scope for registration is always the subscription. Ve výchozím nastavení je řada poskytovatelů prostředků zaregistrována automaticky.By default, many resource providers are automatically registered. Je ale možné, že budete muset některé poskytovatele prostředků zaregistrovat ručně.However, you may need to manually register some resource providers. Chcete-li zaregistrovat poskytovatele prostředků, musíte mít oprávnění k provedení operace /register/action pro poskytovatele prostředků.To register a resource provider, you must have permission to do the /register/action operation for the resource provider. Tato operace je součástí rolí Přispěvatel a Vlastník.This operation is included in the Contributor and Owner roles.

az provider register --namespace Microsoft.Batch

Vrátí zprávu o tom, že probíhá registrace.Which returns a message that registration is on-going.

Pokud v předplatném máte typy prostředků od tohoto poskytovatele prostředků, nemůžete zrušit registraci poskytovatele prostředků.You can't unregister a resource provider when you still have resource types from that resource provider in your subscription.

Pokud chcete zobrazit informace o konkrétním poskytovateli prostředků, použijte:To see information for a particular resource provider, use:

az provider show --namespace Microsoft.Batch

Což vrátí výsledek podobný tomuto:Which returns results similar to:

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

Chcete-li zobrazit typy prostředků pro poskytovatele prostředků, použijte:To see the resource types for a resource provider, use:

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

Který vrátí:Which returns:

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

Verze rozhraní API odpovídá verzi REST API operací, které jsou vydány poskytovatelem prostředků.The API version corresponds to a version of REST API operations that are released by the resource provider. V případě, že poskytovatel prostředků poskytuje nové funkce, uvolňuje novou verzi REST API.As a resource provider enables new features, it releases a new version of the REST API.

K získání dostupných verzí rozhraní API pro typ prostředku použijte:To get the available API versions for a resource type, use:

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

Který vrátí:Which returns:

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.Resource Manager is supported in all regions, but the resources you deploy might not be supported in all regions. Kromě toho můžou mít vaše předplatné omezení, které vám brání v používání některých oblastí, které podporují daný prostředek.In addition, there may be limitations on your subscription that prevent you from using some regions that support the resource.

Chcete-li získat podporovaná umístění pro typ prostředku, použijte.To get the supported locations for a resource type, use.

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

Který vrátí:Which returns:

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

Další krokyNext steps