Zones - List

Referencia

Szolgáltatás:: DNS

API-verzió:: 2018-05-01

Az előfizetés összes erőforráscsoportjának DNS-zónáit sorolja fel.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnszones?api-version=2018-05-01

Opcionális paraméterekkel:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnszones?$top={$top}&api-version=2018-05-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
subscriptionId	path	True	string	Megadja az Azure-előfizetés azonosítóját, amely egyedileg azonosítja a Microsoft Azure-előfizetést.
api-version	query	True	string	Az API-verziót adja meg.
$top	query		integer (int32)	A visszaadni kívánt DNS-zónák maximális száma. Ha nincs megadva, legfeljebb 100 zónát ad vissza.

Válaszok

Name	Típus	Description
200 OK	ZoneListResult	Siker.
Other Status Codes	CloudError	Alapértelmezett válasz. A hibadefiníciónak megfelelően deszerializálja.

Példák

List zones by subscription

Mintakérelem

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/dnszones?api-version=2018-05-01


/**
 * Samples for Zones List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/dns/resource-manager/Microsoft.Network/stable/2018-05-01/examples/ListZonesBySubscription.json
     */
    /**
     * Sample code: List zones by subscription.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listZonesBySubscription(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.dnsZones().manager().serviceClient().getZones().list(null, com.azure.core.util.Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.dns import DnsManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-dns
# USAGE
    python list_zones_by_subscription.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 = DnsManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.zones.list()
    for item in response:
        print(item)


# x-ms-original-file: specification/dns/resource-manager/Microsoft.Network/stable/2018-05-01/examples/ListZonesBySubscription.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 armdns_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dns/armdns"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/c767823fdfd9d5e96bad245e3ea4d14d94a716bb/specification/dns/resource-manager/Microsoft.Network/stable/2018-05-01/examples/ListZonesBySubscription.json
func ExampleZonesClient_NewListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdns.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewZonesClient().NewListPager(&armdns.ZonesClientListOptions{Top: 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.ZoneListResult = armdns.ZoneListResult{
		// 	Value: []*armdns.Zone{
		// 		{
		// 			Name: to.Ptr("zone1"),
		// 			Type: to.Ptr("Microsoft.Network/dnsZones"),
		// 			ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1"),
		// 			Location: to.Ptr("global"),
		// 			Tags: map[string]*string{
		// 				"key1": to.Ptr("value1"),
		// 			},
		// 			Etag: to.Ptr("00000000-0000-0000-0000-000000000000"),
		// 			Properties: &armdns.ZoneProperties{
		// 				MaxNumberOfRecordSets: to.Ptr[int64](5000),
		// 				NameServers: []*string{
		// 					to.Ptr("ns1-01.azure-dns.com"),
		// 					to.Ptr("ns2-01.azure-dns.net"),
		// 					to.Ptr("ns3-01.azure-dns.org"),
		// 					to.Ptr("ns4-01.azure-dns.info")},
		// 					NumberOfRecordSets: to.Ptr[int64](2),
		// 				},
		// 			},
		// 			{
		// 				Name: to.Ptr("zone2"),
		// 				Type: to.Ptr("Microsoft.Network/dnsZones"),
		// 				ID: to.Ptr("/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/dnsZones/zone2"),
		// 				Location: to.Ptr("global"),
		// 				Etag: to.Ptr("00000000-0000-0000-0000-000000000000"),
		// 				Properties: &armdns.ZoneProperties{
		// 					MaxNumberOfRecordSets: to.Ptr[int64](5000),
		// 					NameServers: []*string{
		// 						to.Ptr("ns1-02.azure-dns.com"),
		// 						to.Ptr("ns2-02.azure-dns.net"),
		// 						to.Ptr("ns3-02.azure-dns.org"),
		// 						to.Ptr("ns4-02.azure-dns.info")},
		// 						NumberOfRecordSets: to.Ptr[int64](300),
		// 					},
		// 			}},
		// 		}
	}
}

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

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

/**
 * This sample demonstrates how to Lists the DNS zones in all resource groups in a subscription.
 *
 * @summary Lists the DNS zones in all resource groups in a subscription.
 * x-ms-original-file: specification/dns/resource-manager/Microsoft.Network/stable/2018-05-01/examples/ListZonesBySubscription.json
 */
async function listZonesBySubscription() {
  const subscriptionId = "subid";
  const credential = new DefaultAzureCredential();
  const client = new DnsManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.zones.list()) {
    resArray.push(item);
  }
  console.log(resArray);
}

listZonesBySubscription().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

Mintaválasz

Állapotkód:: 200

{
  "nextLink": "https://servicehost/subscriptions/subid/providers/Microsoft.Network/dnsZones?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "location": "global",
      "name": "zone1",
      "type": "Microsoft.Network/dnsZones",
      "properties": {
        "maxNumberOfRecordSets": 5000,
        "numberOfRecordSets": 2,
        "nameServers": [
          "ns1-01.azure-dns.com",
          "ns2-01.azure-dns.net",
          "ns3-01.azure-dns.org",
          "ns4-01.azure-dns.info"
        ]
      },
      "tags": {
        "key1": "value1"
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Network/dnsZones/zone2",
      "etag": "00000000-0000-0000-0000-000000000000",
      "location": "global",
      "name": "zone2",
      "type": "Microsoft.Network/dnsZones",
      "properties": {
        "maxNumberOfRecordSets": 5000,
        "numberOfRecordSets": 300,
        "nameServers": [
          "ns1-02.azure-dns.com",
          "ns2-02.azure-dns.net",
          "ns3-02.azure-dns.org",
          "ns4-02.azure-dns.info"
        ]
      }
    }
  ]
}

Definíciók

Name	Description
CloudError	Hibaválasz a szolgáltatástól.
CloudErrorBody	Hibaválasz a szolgáltatástól.
SubResource	Hivatkozás egy másik erőforrásra
Zone	Egy DNS-zónát ismertet.
ZoneListResult	Zónalista- vagy ListAll-műveletre adott válasz.
ZoneType	A DNS-zóna típusa (nyilvános vagy privát).

CloudError

Objektum

Hibaválasz a szolgáltatástól.

Name	Típus	Description
error	CloudErrorBody	Felhőbeli hibatörzs.

CloudErrorBody

Objektum

Hibaválasz a szolgáltatástól.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
details	CloudErrorBody[]	A hiba további részleteinek listája.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
target	string	Az adott hiba célja. Például a tulajdonság neve hibás.

SubResource

Objektum

Hivatkozás egy másik erőforrásra

Name	Típus	Description
id	string	Erőforrás-azonosító.

Zone

Objektum

Egy DNS-zónát ismertet.

Name	Típus	Alapértelmezett érték	Description
etag	string		A zóna etagje.
id	string		Erőforrás-azonosító.
location	string		Erőforrás helye.
name	string		Erőforrás neve.
properties.maxNumberOfRecordSets	integer (int64)		Az ebben a DNS-zónában létrehozható rekordhalmazok maximális száma. Ez egy írásvédett tulajdonság, és az érték beállítására tett kísérletek figyelmen kívül lesznek hagyva.
properties.maxNumberOfRecordsPerRecordSet	integer (int64)		Az ebben a DNS-zónában létrehozható rekordhalmazonkénti rekordok maximális száma. Ez egy írásvédett tulajdonság, és az érték beállítására tett kísérletek figyelmen kívül lesznek hagyva.
properties.nameServers	string[]		A DNS-zóna névkiszolgálói. Ez egy írásvédett tulajdonság, és az érték beállítására tett kísérletek figyelmen kívül lesznek hagyva.
properties.numberOfRecordSets	integer (int64)		A DNS-zónában lévő rekordhalmazok aktuális száma. Ez egy írásvédett tulajdonság, és az érték beállítására tett kísérletek figyelmen kívül lesznek hagyva.
properties.registrationVirtualNetworks	SubResource[]		A DNS-zónában állomásneveket regisztráló virtuális hálózatokra mutató hivatkozások listája. Ez csak akkor érvényes, ha a ZoneType privát.
properties.resolutionVirtualNetworks	SubResource[]		A DNS-zóna rekordjait feloldó virtuális hálózatokra mutató hivatkozások listája. Ez csak akkor érvényes, ha a ZoneType privát.
properties.zoneType	ZoneType	Public	A DNS-zóna típusa (nyilvános vagy privát).
tags	object		Erőforráscímkék.
type	string		Erőforrás típusa.

ZoneListResult

Objektum

Zónalista- vagy ListAll-műveletre adott válasz.

Name	Típus	Description
nextLink	string	A folytatási jogkivonat az eredmények következő oldalához.
value	Zone[]	Információ a DNS-zónákról.

ZoneType

Enumerálás

A DNS-zóna típusa (nyilvános vagy privát).

Érték	Description
Private
Public

Megosztás a következőn keresztül:

Zones - List

URI-paraméterek

Válaszok

Példák

List zones by subscription

Mintakérelem

Mintaválasz

Definíciók

CloudError

CloudErrorBody

SubResource

Zone

ZoneListResult

ZoneType