Providers - Get

Başvuru

Service:: Resource Management

API Version:: 2021-04-01

Belirtilen kaynak sağlayıcısını alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/{resourceProviderNamespace}?api-version=2021-04-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/{resourceProviderNamespace}?$expand={$expand}&api-version=2021-04-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceProviderNamespace	path	True	string	Kaynak sağlayıcısının ad alanı.
subscriptionId	path	True	string	Microsoft Azure abonelik kimliği.
api-version	query	True	string	Bu işlem için kullanılacak API sürümü.
$expand	query		string	$expand sorgu parametresi. Örneğin, yanıta özellik diğer adlarını eklemek için $expand=resourceTypes/aliases kullanın.

Yanıtlar

Name	Tür	Description
200 OK	Provider	Tamam - Kaynak sağlayıcısı hakkındaki bilgileri döndürür.
Other Status Codes	CloudError	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Get provider.

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.TestRP1?api-version=2021-04-01

package armresources_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresources"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4fd842fb73656039ec94ce367bcedee25a57bd18/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/GetProvider.json
func ExampleProvidersClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armresources.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewProvidersClient().Get(ctx, "Microsoft.TestRP1", &armresources.ProvidersClientGetOptions{Expand: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Provider = armresources.Provider{
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.TestRP1"),
	// 	Namespace: to.Ptr("Microsoft.TestRP1"),
	// 	RegistrationPolicy: to.Ptr("RegistrationRequired"),
	// 	RegistrationState: to.Ptr("Registering"),
	// 	ResourceTypes: []*armresources.ProviderResourceType{
	// 		{
	// 			APIVersions: []*string{
	// 				to.Ptr("2018-01-01"),
	// 				to.Ptr("2015-05-01")},
	// 				Capabilities: to.Ptr("CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"),
	// 				LocationMappings: []*armresources.ProviderExtendedLocation{
	// 					{
	// 						Type: to.Ptr("EdgeZone"),
	// 						ExtendedLocations: []*string{
	// 							to.Ptr("LosAngeles"),
	// 							to.Ptr("LosAngeles2")},
	// 							Location: to.Ptr("West US"),
	// 					}},
	// 					Locations: []*string{
	// 						to.Ptr("West US")},
	// 						ResourceType: to.Ptr("TestResourceType"),
	// 					},
	// 					{
	// 						APIVersions: []*string{
	// 							to.Ptr("2018-01-01"),
	// 							to.Ptr("2015-05-01")},
	// 							Capabilities: to.Ptr("CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"),
	// 							Locations: []*string{
	// 								to.Ptr("West US")},
	// 								ResourceType: to.Ptr("TestResourceTypeSibling"),
	// 						}},
	// 					}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ResourceManagementClient } = require("@azure/arm-resources");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets the specified resource provider.
 *
 * @summary Gets the specified resource provider.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/GetProvider.json
 */
async function getProvider() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceProviderNamespace = "Microsoft.TestRP1";
  const credential = new DefaultAzureCredential();
  const client = new ResourceManagementClient(credential, subscriptionId);
  const result = await client.providers.get(resourceProviderNamespace);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.TestRP1",
  "namespace": "Microsoft.TestRP1",
  "registrationState": "Registering",
  "registrationPolicy": "RegistrationRequired",
  "resourceTypes": [
    {
      "resourceType": "TestResourceType",
      "locations": [
        "West US"
      ],
      "apiVersions": [
        "2018-01-01",
        "2015-05-01"
      ],
      "locationMappings": [
        {
          "location": "West US",
          "type": "EdgeZone",
          "extendedLocations": [
            "LosAngeles",
            "LosAngeles2"
          ]
        }
      ],
      "capabilities": "CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"
    },
    {
      "resourceType": "TestResourceTypeSibling",
      "locations": [
        "West US"
      ],
      "apiVersions": [
        "2018-01-01",
        "2015-05-01"
      ],
      "capabilities": "CrossResourceGroupResourceMove, CrossSubscriptionResourceMove, SupportsTags, SupportsLocation"
    }
  ]
}

Tanımlar

Name	Description
Alias	Diğer ad türü.
AliasPath	Diğer ad için yolların türü.
AliasPathAttributes	Diğer ad yolunun başvurduğunu belirtecin öznitelikleri.
AliasPathMetadata
AliasPathTokenType	Diğer ad yolunun başvurduğunu belirtecin türü.
AliasPattern	Diğer ad yolu için desenin türü.
AliasPatternType	Diğer ad deseninin türü
AliasType	Diğer adın türü.
ApiProfile
CloudError	Kaynak yönetimi isteği için hata yanıtı.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorResponse	Hata Yanıtı
Provider	Kaynak sağlayıcısı bilgileri.
ProviderAuthorizationConsentState	Sağlayıcı yetkilendirme onayı durumu.
ProviderExtendedLocation	Sağlayıcı genişletilmiş konumu.
ProviderResourceType	Kaynak sağlayıcısı tarafından yönetilen kaynak türü.
ZoneMapping

Alias

Diğer ad türü.

Name	Tür	Description
defaultMetadata	AliasPathMetadata	Varsayılan diğer ad yolu meta verileri. Varsayılan yol ve meta verileri olmayan diğer ad yolları için geçerlidir
defaultPath	string	Diğer ad için varsayılan yol.
defaultPattern	AliasPattern	Diğer ad için varsayılan desen.
name	string	Diğer ad.
paths	AliasPath[]	Diğer adın yolları.
type	AliasType	Diğer adın türü.

AliasPath

Diğer ad için yolların türü.

Name	Tür	Description
apiVersions	string[]	API sürümleri.
metadata	AliasPathMetadata	Diğer ad yolunun meta verileri. Eksikse diğer adın varsayılan meta verilerine geri dönün.
path	string	Diğer adın yolu.
pattern	AliasPattern	Diğer ad yolunun deseni.

AliasPathAttributes

Diğer ad yolunun başvurduğunu belirtecin öznitelikleri.

Name	Tür	Description
Modifiable	string	Diğer ad yolunun başvurduğunu belirteç, 'değiştir' etkisi olan ilkeler tarafından değiştirilebilir.
None	string	Diğer ad yolunun başvurduğunu belirtecin özniteliği yoktur.

AliasPathMetadata

Name	Tür	Description
attributes	AliasPathAttributes	Diğer ad yolunun başvurduğunu belirtecin öznitelikleri.
type	AliasPathTokenType	Diğer ad yolunun başvurduğunu belirtecin türü.

AliasPathTokenType

Diğer ad yolunun başvurduğunu belirtecin türü.

Name	Tür	Description
Any	string	Belirteç türü herhangi bir şey olabilir.
Array	string	Belirteç türü dizidir.
Boolean	string	Belirteç türü boole değeridir.
Integer	string	Belirteç türü tamsayıdır.
NotSpecified	string	Belirteç türü belirtilmemiş.
Number	string	Belirteç türü sayıdır.
Object	string	Belirteç türü nesnedir.
String	string	Belirteç türü dizedir.

AliasPattern

Diğer ad yolu için desenin türü.

Name	Tür	Description
phrase	string	Diğer ad deseni tümceciği.
type	AliasPatternType	Diğer ad deseninin türü
variable	string	Diğer ad desen değişkeni.

AliasPatternType

Diğer ad deseninin türü

Name	Tür	Description
Extract	string	Ayıkla, izin verilen tek değerdir.
NotSpecified	string	NotSpecified'a izin verilmiyor.

AliasType

Diğer adın türü.

Name	Tür	Description
Mask	string	Diğer ad değeri gizlidir.
NotSpecified	string	Diğer ad türü bilinmiyor (diğer ad türü sağlamamayla aynıdır).
PlainText	string	Diğer ad değeri gizli değil.

ApiProfile

Name	Tür	Description
apiVersion	string	API sürümü.
profileVersion	string	Profil sürümü.

CloudError

Kaynak yönetimi isteği için hata yanıtı.

Name	Tür	Description
error	ErrorResponse	Hata Yanıtı Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıtı biçimini de izler.)

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorResponse

Hata Yanıtı

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorResponse[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

Provider

Kaynak sağlayıcısı bilgileri.

Name	Tür	Description
id	string	Sağlayıcı kimliği.
namespace	string	Kaynak sağlayıcısının ad alanı.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	Sağlayıcı yetkilendirme onayı durumu.
registrationPolicy	string	Kaynak sağlayıcısının kayıt ilkesi.
registrationState	string	Kaynak sağlayıcısının kayıt durumu.
resourceTypes	ProviderResourceType[]	Sağlayıcı kaynak türlerinin koleksiyonu.

ProviderAuthorizationConsentState

Sağlayıcı yetkilendirme onayı durumu.

Name	Tür	Description
Consented	string
NotRequired	string
NotSpecified	string
Required	string

ProviderExtendedLocation

Sağlayıcı genişletilmiş konumu.

Name	Tür	Description
extendedLocations	string[]	Azure konumu için genişletilmiş konumlar.
location	string	Azure konumu.
type	string	Genişletilmiş konum türü.

ProviderResourceType

Kaynak sağlayıcısı tarafından yönetilen kaynak türü.

Name	Tür	Description
aliases	Alias[]	Bu kaynak türü tarafından desteklenen diğer adlar.
apiProfiles	ApiProfile[]	Kaynak sağlayıcısı için API profilleri.
apiVersions	string[]	API sürümü.
capabilities	string	Bu kaynak türü tarafından sunulan ek özellikler.
defaultApiVersion	string	Varsayılan API sürümü.
locationMappings	ProviderExtendedLocation[]	Bu kaynak türü tarafından desteklenen konum eşlemeleri.
locations	string[]	Bu kaynak türünün oluşturulabileceği konum koleksiyonu.
properties	object	Özellikler.
resourceType	string	Kaynak türü.
zoneMappings	ZoneMapping[]

ZoneMapping

Name	Tür	Description
location	string	Bölge eşlemesinin konumu.
zones	string[]