Edge Nodes - List

リファレンス

サービス:: CDN

API バージョン:: 2024-02-01

Edgenode は、CDN コンテンツをエンドユーザーに配信するために使用されるグローバルなポイントオブプレゼンス (POP) の場所です。

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

URI パラメーター

名前	/	必須	型	説明
api-version	query	True	string	クライアント要求で使用される API のバージョン。現在のバージョンは 2024-02-01 です。

応答

名前	型	説明
200 OK	EdgenodeResult	OK です。要求は成功しました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明する CDN エラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントの借用

例

EdgeNodes_List

要求のサンプル

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


/**
 * Samples for EdgeNodes List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/cdn/resource-manager/Microsoft.Cdn/stable/2024-02-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/2024-02-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/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/cdn/resource-manager/Microsoft.Cdn/stable/2024-02-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/2024-02-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

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

// Generated from example definition: specification/cdn/resource-manager/Microsoft.Cdn/stable/2024-02-01/examples/EdgeNodes_List.json
// this example is just showing the usage of "EdgeNodes_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;

// invoke the operation and iterate over the result
await foreach (EdgeNode item in tenantResource.GetEdgeNodesAsync())
{
    Console.WriteLine($"Succeeded: {item}");
}

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

応答のサンプル

状態コード:: 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
              }
            ]
          }
        ]
      }
    }
  ]
}

定義

名前	説明
cidrIpAddress	CIDR IP アドレス
EdgeNode	Edgenode は、CDN コンテンツをエンドユーザーに配信するために使用されるグローバルなポイントオブプレゼンス (POP) の場所です。
EdgenodeResult	CDN エッジノードを一覧表示する要求の結果。 IP アドレスグループの一覧と、次の結果セットを取得するための URL リンクが含まれています。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
IdentityType	リソースを作成または変更する ID の種類
IpAddressGroup	CDN IP アドレスグループ
SystemData	システムデータの読み取り専用

cidrIpAddress

CIDR IP アドレス

名前	型	説明
baseIpAddress	string	IP アドレス自体。
prefixLength	integer	IP アドレスのプレフィックスの長さ。

EdgeNode

Edgenode は、CDN コンテンツをエンドユーザーに配信するために使用されるグローバルなポイントオブプレゼンス (POP) の場所です。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.ipAddressGroups	IpAddressGroup[]	IP アドレスグループの一覧。
systemData	SystemData	システムデータの読み取り専用
type	string	リソースの種類。

EdgenodeResult

CDN エッジノードを一覧表示する要求の結果。 IP アドレスグループの一覧と、次の結果セットを取得するための URL リンクが含まれています。

名前	型	説明
nextLink	string	次のエッジノードリストの結果 (存在する場合) のセットを取得する URL。
value	EdgeNode[]	CDN サービスのエッジノード。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細です。
message	string	エラーメッセージ。
target	string	エラーのターゲット。

ErrorResponse

エラー応答

名前	型	説明
error	ErrorDetail	error オブジェクト。

IdentityType

リソースを作成または変更する ID の種類

名前	型	説明
application	string
key	string
managedIdentity	string
user	string

IpAddressGroup

CDN IP アドレスグループ

名前	型	説明
deliveryRegion	string	IP アドレスグループの配信リージョン
ipv4Addresses	cidrIpAddress[]	ip v4 アドレスの一覧。
ipv6Addresses	cidrIpAddress[]	ip v6 アドレスの一覧。

SystemData

システムデータの読み取り専用

名前	型	説明
createdAt	string	リソース作成のタイムスタンプ (UTC)
createdBy	string	リソースを作成した ID の識別子
createdByType	IdentityType	リソースを作成した ID の種類
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID の識別子
lastModifiedByType	IdentityType	リソースを最後に変更した ID の種類