Alias - List

Odwołanie

Usługa:: Subscription

Wersja interfejsu API:: 2021-10-01

Lista subskrypcji aliasu.

GET https://management.azure.com/providers/Microsoft.Subscription/aliases?api-version=2021-10-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
api-version	query	True	string	Wersja interfejsu API do użycia z żądaniem klienta. Bieżąca wersja to 2021-10-01

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SubscriptionAliasListResult	Szczegóły subskrypcji.
Other Status Codes	ErrorResponseBody	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ListAlias

Przykładowe żądanie

GET https://management.azure.com/providers/Microsoft.Subscription/aliases?api-version=2021-10-01

from azure.identity import DefaultAzureCredential
from azure.mgmt.subscription import SubscriptionClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-subscription
# USAGE
    python list_alias.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SubscriptionClient(
        credential=DefaultAzureCredential(),
    )

    response = client.alias.list()
    print(response)


# x-ms-original-file: specification/subscription/resource-manager/Microsoft.Subscription/stable/2021-10-01/examples/listAlias.json
if __name__ == "__main__":
    main()

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

package armsubscription_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/subscription/armsubscription"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7a2ac91de424f271cf91cc8009f3fe9ee8249086/specification/subscription/resource-manager/Microsoft.Subscription/stable/2021-10-01/examples/listAlias.json
func ExampleAliasClient_List() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsubscription.NewClientFactory(cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAliasClient().List(ctx, 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.AliasListResult = armsubscription.AliasListResult{
	// 	Value: []*armsubscription.AliasResponse{
	// 		{
	// 			Name: to.Ptr("string"),
	// 			Type: to.Ptr("string"),
	// 			ID: to.Ptr("string"),
	// 			Properties: &armsubscription.AliasResponseProperties{
	// 				AcceptOwnershipState: to.Ptr(armsubscription.AcceptOwnershipPending),
	// 				AcceptOwnershipURL: to.Ptr("/providers/Microsoft.Subscription/e2283d0f-acad-4904-b803-627dd74cc072/acceptOwnership"),
	// 				BillingScope: to.Ptr("/billingAccounts/af6231a7-7f8d-4fcc-a993-dd8466108d07:c663dac6-a9a5-405a-8938-cd903e12ab5b_2019_05_31/billingProfiles/QWDQ-QWHI-AUW-SJDO-DJH/invoiceSections/FEUF-EUHE-ISJ-SKDW-DJH"),
	// 				DisplayName: to.Ptr("Test Subscription"),
	// 				ProvisioningState: to.Ptr(armsubscription.ProvisioningStateSucceeded),
	// 				SubscriptionID: to.Ptr("e2283d0f-acad-4904-b803-627dd74cc072"),
	// 				SubscriptionOwnerID: to.Ptr("f09b39eb-c496-482c-9ab9-afd799572f4c"),
	// 				Tags: map[string]*string{
	// 					"tag1": to.Ptr("Messi"),
	// 					"tag2": to.Ptr("Ronaldo"),
	// 					"tag3": to.Ptr("Lebron"),
	// 				},
	// 				Workload: to.Ptr(armsubscription.WorkloadProduction),
	// 			},
	// 		},
	// 		{
	// 			Name: to.Ptr("string"),
	// 			Type: to.Ptr("string"),
	// 			ID: to.Ptr("string"),
	// 			Properties: &armsubscription.AliasResponseProperties{
	// 				AcceptOwnershipState: to.Ptr(armsubscription.AcceptOwnershipPending),
	// 				AcceptOwnershipURL: to.Ptr("/providers/Microsoft.Subscription/091c6e56-a835-4422-a082-0427308ca9ee/acceptOwnership"),
	// 				BillingScope: to.Ptr("/billingAccounts/af6231a7-7f8d-4fcc-a993-dd8466108d07:c663dac6-a9a5-405a-8938-cd903e12ab5b_2019_05_31/billingProfiles/QWDQ-QWHI-AUW-SJDO-DJH/invoiceSections/FEUF-EUHE-ISJ-SKDW-DJH"),
	// 				DisplayName: to.Ptr("Test Subscription 2"),
	// 				ProvisioningState: to.Ptr(armsubscription.ProvisioningStateSucceeded),
	// 				SubscriptionID: to.Ptr("091c6e56-a835-4422-a082-0427308ca9ee"),
	// 				SubscriptionOwnerID: to.Ptr("f09b39eb-c496-482c-9ab9-afd799572f4c"),
	// 				Tags: map[string]*string{
	// 					"tag1": to.Ptr("Messi2"),
	// 					"tag2": to.Ptr("Ronaldo2"),
	// 					"tag3": to.Ptr("Lebron2"),
	// 				},
	// 				Workload: to.Ptr(armsubscription.WorkloadProduction),
	// 			},
	// 	}},
	// }
}

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

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

/**
 * This sample demonstrates how to List Alias Subscription.
 *
 * @summary List Alias Subscription.
 * x-ms-original-file: specification/subscription/resource-manager/Microsoft.Subscription/stable/2021-10-01/examples/listAlias.json
 */
async function listAlias() {
  const credential = new DefaultAzureCredential();
  const client = new SubscriptionClient(credential);
  const result = await client.alias.list();
  console.log(result);
}

listAlias().catch(console.error);

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

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Subscription;
using Azure.ResourceManager.Subscription.Models;

// Generated from example definition: specification/subscription/resource-manager/Microsoft.Subscription/stable/2021-10-01/examples/listAlias.json
// this example is just showing the usage of "Alias_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this TenantResource created on azure
// for more information of creating TenantResource, please refer to the document of TenantResource
var tenantResource = client.GetTenants().GetAllAsync().GetAsyncEnumerator().Current;

// get the collection of this SubscriptionAliasResource
SubscriptionAliasCollection collection = tenantResource.GetSubscriptionAliases();

// invoke the operation and iterate over the result
await foreach (SubscriptionAliasResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    SubscriptionAliasData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

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

Przykładowa odpowiedź

Kod stanu:: 200

{
  "value": [
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "properties": {
        "subscriptionId": "e2283d0f-acad-4904-b803-627dd74cc072",
        "displayName": "Test Subscription",
        "provisioningState": "Accepted",
        "acceptOwnershipUrl": "/providers/Microsoft.Subscription/e2283d0f-acad-4904-b803-627dd74cc072/acceptOwnership",
        "acceptOwnershipState": "Pending",
        "billingScope": "/billingAccounts/af6231a7-7f8d-4fcc-a993-dd8466108d07:c663dac6-a9a5-405a-8938-cd903e12ab5b_2019_05_31/billingProfiles/QWDQ-QWHI-AUW-SJDO-DJH/invoiceSections/FEUF-EUHE-ISJ-SKDW-DJH",
        "workload": "Production",
        "resellerId": null,
        "subscriptionOwnerId": "f09b39eb-c496-482c-9ab9-afd799572f4c",
        "managementGroupId": null,
        "tags": {
          "tag1": "Messi",
          "tag2": "Ronaldo",
          "tag3": "Lebron"
        }
      }
    },
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "properties": {
        "subscriptionId": "091c6e56-a835-4422-a082-0427308ca9ee",
        "displayName": "Test Subscription 2",
        "provisioningState": "Accepted",
        "acceptOwnershipUrl": "/providers/Microsoft.Subscription/091c6e56-a835-4422-a082-0427308ca9ee/acceptOwnership",
        "acceptOwnershipState": "Pending",
        "billingScope": "/billingAccounts/af6231a7-7f8d-4fcc-a993-dd8466108d07:c663dac6-a9a5-405a-8938-cd903e12ab5b_2019_05_31/billingProfiles/QWDQ-QWHI-AUW-SJDO-DJH/invoiceSections/FEUF-EUHE-ISJ-SKDW-DJH",
        "workload": "Production",
        "resellerId": null,
        "subscriptionOwnerId": "f09b39eb-c496-482c-9ab9-afd799572f4c",
        "managementGroupId": null,
        "tags": {
          "tag1": "Messi2",
          "tag2": "Ronaldo2",
          "tag3": "Lebron2"
        }
      }
    }
  ],
  "nextLink": null
}

Definicje

Nazwa	Opis
AcceptOwnership	Stan akceptowania własności zasobu.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorResponse	Opisuje format odpowiedzi Błąd.
ErrorResponseBody	Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.
ProvisioningState	Stan aprowizacji zasobu.
SubscriptionAliasListResult	Lista aliasów.
SubscriptionAliasResponse	Informacje o subskrypcji z aliasem.
SubscriptionAliasResponseProperties	Umieść właściwości wyniku tworzenia subskrypcji.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
workload	Typ obciążenia subskrypcji. Może to być środowisko produkcyjne lub devtest.

AcceptOwnership

Stan akceptowania własności zasobu.

Nazwa	Typ	Opis
Completed	string
Expired	string
Pending	string

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorResponse

Opisuje format odpowiedzi Błąd.

Nazwa	Typ	Opis
code	string	Kod błędu
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ErrorResponseBody

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Nazwa	Typ	Opis
code	string	Kod błędu
error	ErrorResponse	Szczegóły błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ProvisioningState

Stan aprowizacji zasobu.

Nazwa	Typ	Opis
Accepted	string
Pending	string
Succeeded	string

SubscriptionAliasListResult

Lista aliasów.

Nazwa	Typ	Opis
nextLink	string	Link (adres URL) do następnej strony wyników.
value	SubscriptionAliasResponse[]	Lista aliasów.

SubscriptionAliasResponse

Informacje o subskrypcji z aliasem.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu aliasu.
name	string	Identyfikator aliasu.
properties	SubscriptionAliasResponseProperties	Właściwości odpowiedzi aliasu subskrypcji.
systemData	systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
type	string	Typ zasobu, Microsoft.Subscription/aliases.

SubscriptionAliasResponseProperties

Umieść właściwości wyniku tworzenia subskrypcji.

Nazwa	Typ	Opis
acceptOwnershipState	AcceptOwnership	Stan akceptowania własności zasobu.
acceptOwnershipUrl	string	Adres URL umożliwiający zaakceptowanie własności subskrypcji.
billingScope	string	Zakres rozliczeniowy subskrypcji. W przypadku customerLed i FieldLed — /billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName} dla PartnerLed — /billingAccounts/{billingAccountName}/customers/{customerName} dla starszej wersji ea — /billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}
createdTime	string	Czas utworzenia
displayName	string	Wyświetlana nazwa subskrypcji.
managementGroupId	string	Identyfikator grupy zarządzania.
provisioningState	ProvisioningState	Stan aprowizacji zasobu.
resellerId	string	Identyfikator odsprzedawcy
subscriptionId	string	Nowo utworzony identyfikator subskrypcji.
subscriptionOwnerId	string	Identyfikator właściciela subskrypcji
tags	object	Tagi dla subskrypcji
workload	workload	Typ obciążenia subskrypcji. Może to być środowisko produkcyjne lub devtest.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

workload

Typ obciążenia subskrypcji. Może to być środowisko produkcyjne lub devtest.

Nazwa	Typ	Opis
DevTest	string
Production	string

Udostępnij za pośrednictwem

Alias - List

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

ListAlias

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AcceptOwnership

createdByType

ErrorResponse

ErrorResponseBody

ProvisioningState

SubscriptionAliasListResult

SubscriptionAliasResponse

SubscriptionAliasResponseProperties

systemData

workload

Dodatkowe zasoby