Subscriptions - List

Layanan:: Resource Management

Versi API:: 2022-12-01

Mendapatkan semua langganan untuk penyewa.

GET https://management.azure.com/subscriptions?api-version=2022-12-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	SubscriptionListResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	CloudError	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

GetAllSubscriptions

Permintaan sampel

GET https://management.azure.com/subscriptions?api-version=2022-12-01

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.subscriptions import SubscriptionClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-subscriptions
# USAGE
    python get_subscriptions.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.subscriptions.list()
    for item in response:
        print(item)


# x-ms-original-file: 2022-12-01/GetSubscriptions.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 armsubscriptions_test

import (
	"context"
	"log"

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

// Generated from example definition: 2022-12-01/GetSubscriptions.json
func ExampleClient_NewListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsubscriptions.NewClientFactory(cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewClient().NewListPager(nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page = armsubscriptions.ClientListResponse{
		// 	SubscriptionListResult: armsubscriptions.SubscriptionListResult{
		// 		NextLink: to.Ptr("http://nextlink"),
		// 		Value: []*armsubscriptions.Subscription{
		// 			{
		// 				AuthorizationSource: to.Ptr("RoleBased"),
		// 				DisplayName: to.Ptr("Example Subscription"),
		// 				ID: to.Ptr("/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05"),
		// 				ManagedByTenants: []*armsubscriptions.ManagedByTenant{
		// 					{
		// 						TenantID: to.Ptr("8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"),
		// 					},
		// 				},
		// 				State: to.Ptr(armsubscriptions.SubscriptionStateEnabled),
		// 				SubscriptionID: to.Ptr("291bba3f-e0a5-47bc-a099-3bdcb2a50a05"),
		// 				SubscriptionPolicies: &armsubscriptions.SubscriptionPolicies{
		// 					LocationPlacementID: to.Ptr("Internal_2014-09-01"),
		// 					QuotaID: to.Ptr("Internal_2014-09-01"),
		// 					SpendingLimit: to.Ptr(armsubscriptions.SpendingLimitOff),
		// 				},
		// 				Tags: map[string]*string{
		// 					"tagKey1": to.Ptr("tagValue1"),
		// 					"tagKey2": to.Ptr("tagValue2"),
		// 				},
		// 				TenantID: to.Ptr("31c75423-32d6-4322-88b7-c478bdde4858"),
		// 			},
		// 			{
		// 				AuthorizationSource: to.Ptr("RoleBased"),
		// 				DisplayName: to.Ptr("Example Subscription2"),
		// 				ID: to.Ptr("/subscriptions/72ac930a-f34e-42d8-b06d-dc2a9e12ed71"),
		// 				ManagedByTenants: []*armsubscriptions.ManagedByTenant{
		// 					{
		// 						TenantID: to.Ptr("8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"),
		// 					},
		// 					{
		// 						TenantID: to.Ptr("f7fb6af2-321d-47c8-9c0f-b0239eaad39a"),
		// 					},
		// 				},
		// 				State: to.Ptr(armsubscriptions.SubscriptionStateEnabled),
		// 				SubscriptionID: to.Ptr("72ac930a-f34e-42d8-b06d-dc2a9e12ed71"),
		// 				SubscriptionPolicies: &armsubscriptions.SubscriptionPolicies{
		// 					LocationPlacementID: to.Ptr("Internal_2014-09-01"),
		// 					QuotaID: to.Ptr("Internal_2014-09-01"),
		// 					SpendingLimit: to.Ptr(armsubscriptions.SpendingLimitOff),
		// 				},
		// 				Tags: map[string]*string{
		// 					"tagKey1": to.Ptr("tagValue1"),
		// 					"tagKey2": to.Ptr("tagValue2"),
		// 				},
		// 				TenantID: to.Ptr("2a0ff0de-96b2-4859-bb7c-a430d07a3e0c"),
		// 			},
		// 		},
		// 	},
		// }
	}
}

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-resources-subscriptions");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to gets all subscriptions for a tenant.
 *
 * @summary gets all subscriptions for a tenant.
 * x-ms-original-file: 2022-12-01/GetSubscriptions.json
 */
async function getAllSubscriptions() {
  const credential = new DefaultAzureCredential();
  const client = new SubscriptionClient(credential);
  const resArray = new Array();
  for await (const item of client.subscriptions.list()) {
    resArray.push(item);
  }

  console.log(resArray);
}

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

Respon sampel

Kode status:: 200

{
  "nextLink": "http://nextlink",
  "value": [
    {
      "authorizationSource": "RoleBased",
      "displayName": "Example Subscription",
      "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
      "managedByTenants": [
        {
          "tenantId": "8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"
        }
      ],
      "state": "Enabled",
      "subscriptionId": "291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
      "subscriptionPolicies": {
        "locationPlacementId": "Internal_2014-09-01",
        "quotaId": "Internal_2014-09-01",
        "spendingLimit": "Off"
      },
      "tags": {
        "tagKey1": "tagValue1",
        "tagKey2": "tagValue2"
      },
      "tenantId": "31c75423-32d6-4322-88b7-c478bdde4858"
    },
    {
      "authorizationSource": "RoleBased",
      "displayName": "Example Subscription2",
      "id": "/subscriptions/72ac930a-f34e-42d8-b06d-dc2a9e12ed71",
      "managedByTenants": [
        {
          "tenantId": "8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"
        },
        {
          "tenantId": "f7fb6af2-321d-47c8-9c0f-b0239eaad39a"
        }
      ],
      "state": "Enabled",
      "subscriptionId": "72ac930a-f34e-42d8-b06d-dc2a9e12ed71",
      "subscriptionPolicies": {
        "locationPlacementId": "Internal_2014-09-01",
        "quotaId": "Internal_2014-09-01",
        "spendingLimit": "Off"
      },
      "tags": {
        "tagKey1": "tagValue1",
        "tagKey2": "tagValue2"
      },
      "tenantId": "2a0ff0de-96b2-4859-bb7c-a430d07a3e0c"
    }
  ]
}

Definisi

Nama	Deskripsi
CloudError	Respons kesalahan untuk permintaan manajemen sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
ManagedByTenant	Informasi tentang penyewa yang mengelola langganan.
SpendingLimit	Batas pengeluaran langganan.
Subscription	Informasi langganan.
SubscriptionListResult	Respons operasi daftar langganan.
SubscriptionPolicies	Kebijakan langganan.
SubscriptionState	Status langganan. Nilai yang mungkin diaktifkan, Diperingatkan, PastDue, Dinonaktifkan, dan Dihapus.

CloudError

Objek

Respons kesalahan untuk permintaan manajemen sumber daya.

Nama	Jenis	Deskripsi
error	ErrorResponse	Tanggapan kesalahan Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ManagedByTenant

Objek

Informasi tentang penyewa yang mengelola langganan.

Nama	Jenis	Deskripsi
tenantId	string	ID penyewa dari penyewa pengelola. Ini adalah GUID.

SpendingLimit

Enumerasi

Batas pengeluaran langganan.

Nilai	Deskripsi
On	Di
Off	Nonaktif
CurrentPeriodOff	CurrentPeriodOff

Subscription

Objek

Informasi langganan.

Nama	Jenis	Deskripsi
authorizationSource	string	Sumber otorisasi permintaan. Nilai yang valid adalah satu atau beberapa kombinasi Warisan, RoleBased, Bypassed, Direct dan Management. Misalnya, 'Warisan, RoleBased'.
displayName	string	Nama tampilan langganan.
id	string	ID yang sepenuhnya memenuhi syarat untuk langganan. Misalnya, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74
managedByTenants	ManagedByTenant[]	Array yang berisi penyewa yang mengelola langganan.
state	SubscriptionState	Status langganan. Nilai yang mungkin diaktifkan, Diperingatkan, PastDue, Dinonaktifkan, dan Dihapus.
subscriptionId	string	ID langganan.
subscriptionPolicies	SubscriptionPolicies	Kebijakan langganan.
tags	object	Tag yang dilampirkan ke langganan.
tenantId	string	ID penyewa langganan.

SubscriptionListResult

Objek

Respons operasi daftar langganan.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	Subscription[]	Item Langganan di halaman ini

SubscriptionPolicies

Objek

Kebijakan langganan.

Nama	Jenis	Deskripsi
locationPlacementId	string	ID penempatan lokasi langganan. ID menunjukkan wilayah mana yang terlihat untuk langganan. Misalnya, langganan dengan Id penempatan lokasi Public_2014-09-01 memiliki akses ke wilayah publik Azure.
quotaId	string	ID kuota langganan.
spendingLimit	SpendingLimit	Batas pengeluaran langganan.

SubscriptionState

Enumerasi

Status langganan. Nilai yang mungkin diaktifkan, Diperingatkan, PastDue, Dinonaktifkan, dan Dihapus.

Nilai	Deskripsi
Enabled	Enabled
Warned	Diperingatkan
PastDue	Masa Lalu
Disabled	Nonaktif
Deleted	Dihapus