Edge Nodes - List

Odwołanie

Service:: CDN

API Version:: 2023-05-01

Węzły brzegowe to globalne lokalizacje punktów obecności (POP) używane do dostarczania zawartości usługi CDN użytkownikom końcowym.

GET https://management.azure.com/providers/Microsoft.Cdn/edgenodes?api-version=2023-05-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 2023-05-01.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	EdgenodeResult	OK. Żądanie zakończyło się pomyślnie.
Other Status Codes	ErrorResponse	Odpowiedź z błędem usługi CDN opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

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

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

EdgeNodes_List

Sample Request

GET https://management.azure.com/providers/Microsoft.Cdn/edgenodes?api-version=2023-05-01


/** Samples for EdgeNodes List. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/EdgeNodes_List.json
     */
    /**
     * Sample code: EdgeNodes_List.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void edgeNodesList(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.cdnProfiles().manager().serviceClient().getEdgeNodes().list(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.cdn import CdnManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-cdn
# USAGE
    python edge_nodes_list.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 = CdnManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

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


# x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/EdgeNodes_List.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 armcdn_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/cdn/armcdn/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7b551033155a63739b6d28f79b9c07569f6179b8/specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/EdgeNodes_List.json
func ExampleEdgeNodesClient_NewListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcdn.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewEdgeNodesClient().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.EdgenodeResult = armcdn.EdgenodeResult{
		// 	Value: []*armcdn.EdgeNode{
		// 		{
		// 			Name: to.Ptr("Standard_Verizon"),
		// 			Type: to.Ptr("Microsoft.Cdn/edgenodes"),
		// 			ID: to.Ptr("/providers/Microsoft.Cdn/edgenodes/Standard_Verizon"),
		// 			Properties: &armcdn.EdgeNodeProperties{
		// 				IPAddressGroups: []*armcdn.IPAddressGroup{
		// 					{
		// 						DeliveryRegion: to.Ptr("All"),
		// 						IPv4Addresses: []*armcdn.CidrIPAddress{
		// 							{
		// 								BaseIPAddress: to.Ptr("192.229.176.0"),
		// 								PrefixLength: to.Ptr[int32](24),
		// 							},
		// 							{
		// 								BaseIPAddress: to.Ptr("180.240.184.128"),
		// 								PrefixLength: to.Ptr[int32](25),
		// 							},
		// 							{
		// 								BaseIPAddress: to.Ptr("152.195.27.0"),
		// 								PrefixLength: to.Ptr[int32](24),
		// 						}},
		// 						IPv6Addresses: []*armcdn.CidrIPAddress{
		// 							{
		// 								BaseIPAddress: to.Ptr("2606:2800:60f2::"),
		// 								PrefixLength: to.Ptr[int32](48),
		// 							},
		// 							{
		// 								BaseIPAddress: to.Ptr("2606:2800:700c::"),
		// 								PrefixLength: to.Ptr[int32](48),
		// 						}},
		// 				}},
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("Premium_Verizon"),
		// 			Type: to.Ptr("Microsoft.Cdn/edgenodes"),
		// 			ID: to.Ptr("/providers/Microsoft.Cdn/edgenodes/Premium_Verizon"),
		// 			Properties: &armcdn.EdgeNodeProperties{
		// 				IPAddressGroups: []*armcdn.IPAddressGroup{
		// 					{
		// 						DeliveryRegion: to.Ptr("All"),
		// 						IPv4Addresses: []*armcdn.CidrIPAddress{
		// 							{
		// 								BaseIPAddress: to.Ptr("192.229.176.0"),
		// 								PrefixLength: to.Ptr[int32](24),
		// 							},
		// 							{
		// 								BaseIPAddress: to.Ptr("152.195.27.0"),
		// 								PrefixLength: to.Ptr[int32](24),
		// 						}},
		// 						IPv6Addresses: []*armcdn.CidrIPAddress{
		// 							{
		// 								BaseIPAddress: to.Ptr("2606:2800:60f2::"),
		// 								PrefixLength: to.Ptr[int32](48),
		// 							},
		// 							{
		// 								BaseIPAddress: to.Ptr("2606:2800:700c::"),
		// 								PrefixLength: to.Ptr[int32](48),
		// 						}},
		// 				}},
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("Custom_Verizon"),
		// 			Type: to.Ptr("Microsoft.Cdn/edgenodes"),
		// 			ID: to.Ptr("/providers/Microsoft.Cdn/edgenodes/Custom_Verizon"),
		// 			Properties: &armcdn.EdgeNodeProperties{
		// 				IPAddressGroups: []*armcdn.IPAddressGroup{
		// 					{
		// 						DeliveryRegion: to.Ptr("All"),
		// 						IPv4Addresses: []*armcdn.CidrIPAddress{
		// 							{
		// 								BaseIPAddress: to.Ptr("192.229.176.0"),
		// 								PrefixLength: to.Ptr[int32](24),
		// 							},
		// 							{
		// 								BaseIPAddress: to.Ptr("2606:2800:420b::"),
		// 								PrefixLength: to.Ptr[int32](48),
		// 							},
		// 							{
		// 								BaseIPAddress: to.Ptr("2606:2800:700c::"),
		// 								PrefixLength: to.Ptr[int32](48),
		// 						}},
		// 				}},
		// 			},
		// 	}},
		// }
	}
}

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

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

/**
 * This sample demonstrates how to Edgenodes are the global Point of Presence (POP) locations used to deliver CDN content to end users.
 *
 * @summary Edgenodes are the global Point of Presence (POP) locations used to deliver CDN content to end users.
 * x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/EdgeNodes_List.json
 */
async function edgeNodesList() {
  const credential = new DefaultAzureCredential();
  const client = new CdnManagementClient(credential);
  const resArray = new Array();
  for await (let item of client.edgeNodes.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

Sample Response

Status code:: 200

{
  "value": [
    {
      "name": "Standard_Verizon",
      "id": "/providers/Microsoft.Cdn/edgenodes/Standard_Verizon",
      "type": "Microsoft.Cdn/edgenodes",
      "properties": {
        "ipAddressGroups": [
          {
            "deliveryRegion": "All",
            "ipv4Addresses": [
              {
                "baseIpAddress": "192.229.176.0",
                "prefixLength": 24
              },
              {
                "baseIpAddress": "180.240.184.128",
                "prefixLength": 25
              },
              {
                "baseIpAddress": "152.195.27.0",
                "prefixLength": 24
              }
            ],
            "ipv6Addresses": [
              {
                "baseIpAddress": "2606:2800:60f2::",
                "prefixLength": 48
              },
              {
                "baseIpAddress": "2606:2800:700c::",
                "prefixLength": 48
              }
            ]
          }
        ]
      }
    },
    {
      "name": "Premium_Verizon",
      "id": "/providers/Microsoft.Cdn/edgenodes/Premium_Verizon",
      "type": "Microsoft.Cdn/edgenodes",
      "properties": {
        "ipAddressGroups": [
          {
            "deliveryRegion": "All",
            "ipv4Addresses": [
              {
                "baseIpAddress": "192.229.176.0",
                "prefixLength": 24
              },
              {
                "baseIpAddress": "152.195.27.0",
                "prefixLength": 24
              }
            ],
            "ipv6Addresses": [
              {
                "baseIpAddress": "2606:2800:60f2::",
                "prefixLength": 48
              },
              {
                "baseIpAddress": "2606:2800:700c::",
                "prefixLength": 48
              }
            ]
          }
        ]
      }
    },
    {
      "name": "Custom_Verizon",
      "id": "/providers/Microsoft.Cdn/edgenodes/Custom_Verizon",
      "type": "Microsoft.Cdn/edgenodes",
      "properties": {
        "ipAddressGroups": [
          {
            "deliveryRegion": "All",
            "ipv4Addresses": [
              {
                "baseIpAddress": "192.229.176.0",
                "prefixLength": 24
              },
              {
                "baseIpAddress": "2606:2800:420b::",
                "prefixLength": 48
              },
              {
                "baseIpAddress": "2606:2800:700c::",
                "prefixLength": 48
              }
            ]
          }
        ]
      }
    }
  ]
}

Definicje

Nazwa	Opis
cidrIpAddress	Adres IP CIDR
EdgeNode	Edgenode to globalna lokalizacja punktu obecności (POP) używana do dostarczania zawartości usługi CDN użytkownikom końcowym.
EdgenodeResult	Wynik żądania wyświetlenia listy węzłów brzegowych usługi CDN. Zawiera listę grup adresów IP i link adresu URL, aby uzyskać następny zestaw wyników.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
IdentityType	Typ tożsamości, która tworzy/modyfikuje zasoby
IpAddressGroup	Grupa adresów IP usługi CDN
SystemData	Dane systemowe tylko do odczytu

cidrIpAddress

Adres IP CIDR

Nazwa	Typ	Opis
baseIpAddress	string	Sam adres IP.
prefixLength	integer	Długość prefiksu adresu IP.

EdgeNode

Edgenode to globalna lokalizacja punktu obecności (POP) używana do dostarczania zawartości usługi CDN użytkownikom końcowym.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.ipAddressGroups	IpAddressGroup[]	Lista grup adresów IP.
systemData	SystemData	Dane systemowe tylko do odczytu
type	string	Typ zasobu.

EdgenodeResult

Wynik żądania wyświetlenia listy węzłów brzegowych usługi CDN. Zawiera listę grup adresów IP i link adresu URL, aby uzyskać następny zestaw wyników.

Nazwa	Typ	Opis
nextLink	string	Adres URL umożliwiający pobranie następnego zestawu wyników listy edgenode, jeśli istnieją.
value	EdgeNode[]	Węzeł krawędzi usługi CDN.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

IdentityType

Typ tożsamości, która tworzy/modyfikuje zasoby

Nazwa	Typ	Opis
application	string
key	string
managedIdentity	string
user	string

IpAddressGroup

Grupa adresów IP usługi CDN

Nazwa	Typ	Opis
deliveryRegion	string	Region dostarczania grupy adresów IP
ipv4Addresses	cidrIpAddress[]	Lista adresów IP w wersji 4.
ipv6Addresses	cidrIpAddress[]	Lista adresów IP v6.

SystemData

Dane systemowe tylko do odczytu

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

Edge Nodes - List

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

azure_auth

Scopes

Przykłady

EdgeNodes_List

Sample Request

Sample Response

Definicje

cidrIpAddress

EdgeNode

EdgenodeResult

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdentityType

IpAddressGroup

SystemData

Dodatkowe zasoby