Clusters - List Outbound Network Dependencies Endpoints

Ссылка

Service:: Azure Kusto

API Version:: 2022-02-01

Возвращает сетевые конечные точки всех исходящих зависимостей кластера Kusto

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/outboundNetworkDependenciesEndpoints?api-version=2022-02-01

Параметры URI

Name	In	Required	Type	Description
clusterName	path	True	string	Имя кластера Kusto.
resourceGroupName	path	True	string	Имя группы ресурсов, содержащей кластер Kusto.
subscriptionId	path	True	string	Возвращает учетные данные подписки, которые уникально идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.
api-version	query	True	string	Версия КЛИЕНТСКОго API.

Ответы

Name	Type	Description
200 OK	OutboundNetworkDependenciesEndpointListResult	ОК
Other Status Codes	CloudError	Ошибка из RP

Примеры

Get Kusto cluster outbound network dependencies

Sample Request

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster/outboundNetworkDependenciesEndpoints?api-version=2022-02-01

import com.azure.core.util.Context;

/** Samples for Clusters ListOutboundNetworkDependenciesEndpoints. */
public final class Main {
    /*
     * x-ms-original-file: specification/azure-kusto/resource-manager/Microsoft.Kusto/stable/2022-02-01/examples/KustoOutboundNetworkDependenciesList.json
     */
    /**
     * Sample code: Get Kusto cluster outbound network dependencies.
     *
     * @param manager Entry point to KustoManager.
     */
    public static void getKustoClusterOutboundNetworkDependencies(
        com.azure.resourcemanager.kusto.KustoManager manager) {
        manager.clusters().listOutboundNetworkDependenciesEndpoints("kustorptest", "kustoCluster", Context.NONE);
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

package armkusto_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/kusto/armkusto"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/azure-kusto/resource-manager/Microsoft.Kusto/stable/2022-02-01/examples/KustoOutboundNetworkDependenciesList.json
func ExampleClustersClient_NewListOutboundNetworkDependenciesEndpointsPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armkusto.NewClustersClient("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := client.NewListOutboundNetworkDependenciesEndpointsPager("kustorptest",
		"kustoCluster",
		nil)
	for pager.More() {
		nextResult, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range nextResult.Value {
			// TODO: use page item
			_ = v
		}
	}
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

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

/**
 * This sample demonstrates how to Gets the network endpoints of all outbound dependencies of a Kusto cluster
 *
 * @summary Gets the network endpoints of all outbound dependencies of a Kusto cluster
 * x-ms-original-file: specification/azure-kusto/resource-manager/Microsoft.Kusto/stable/2022-02-01/examples/KustoOutboundNetworkDependenciesList.json
 */
async function getKustoClusterOutboundNetworkDependencies() {
  const subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const resourceGroupName = "kustorptest";
  const clusterName = "kustoCluster";
  const credential = new DefaultAzureCredential();
  const client = new KustoManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.clusters.listOutboundNetworkDependenciesEndpoints(
    resourceGroupName,
    clusterName
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

getKustoClusterOutboundNetworkDependencies().catch(console.error);

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster/OutboundNetworkDependenciesEndpoints/AzureActiveDirectory",
      "name": "kustoCluster/AzureActiveDirectory",
      "type": "Microsoft.Kusto/Clusters/OutboundNetworkDependenciesEndpoints",
      "properties": {
        "category": "Azure Active Directory",
        "endpoints": [
          {
            "domainName": "login.microsoftonline.com",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          },
          {
            "domainName": "graph.windows.net",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          },
          {
            "domainName": "graph.microsoft.com",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          },
          {
            "domainName": "graph.microsoft-ppe.com",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          }
        ],
        "provisioningState": "Succeeded"
      }
    },
    {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster/OutboundNetworkDependenciesEndpoints/AzureMonitor",
      "name": "kustoCluster/AzureMonitor",
      "type": "Microsoft.Kusto/Clusters/OutboundNetworkDependenciesEndpoints",
      "properties": {
        "category": "Azure Monitor",
        "endpoints": [
          {
            "domainName": "prod.warmpath.msftcloudes.com",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          },
          {
            "domainName": "gcs.prod.monitoring.core.windows.net",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          },
          {
            "domainName": "production.diagnostics.monitoring.core.windows.net",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          },
          {
            "domainName": "shoebox2.metrics.nsatc.net:443",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          }
        ],
        "provisioningState": "Succeeded"
      }
    },
    {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster/OutboundNetworkDependenciesEndpoints/CertificateAuthority",
      "name": "kustoCluster/CertificateAuthority",
      "type": "Microsoft.Kusto/Clusters/OutboundNetworkDependenciesEndpoints",
      "properties": {
        "category": "Certificate Authority",
        "endpoints": [
          {
            "domainName": "ocsp.msocsp.com",
            "endpointDetails": [
              {
                "port": 80
              }
            ]
          },
          {
            "domainName": "ocsp.digicert.com",
            "endpointDetails": [
              {
                "port": 80
              }
            ]
          },
          {
            "domainName": "crl3.digicert.com",
            "endpointDetails": [
              {
                "port": 80
              }
            ]
          },
          {
            "domainName": "crl.microsoft.com",
            "endpointDetails": [
              {
                "port": 80
              }
            ]
          },
          {
            "domainName": "www.microsoft.com",
            "endpointDetails": [
              {
                "port": 80
              }
            ]
          }
        ],
        "provisioningState": "Succeeded"
      }
    },
    {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster/OutboundNetworkDependenciesEndpoints/AzureStorage",
      "name": "kustoCluster/AzureStorage",
      "type": "Microsoft.Kusto/Clusters/OutboundNetworkDependenciesEndpoints",
      "properties": {
        "category": "Azure Storage",
        "endpoints": [
          {
            "domainName": "clusterinternalsa.blob.core.windows.net",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          },
          {
            "domainName": "clusterinternalsa.queue.core.windows.net",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          },
          {
            "domainName": "clusterinternalsa.table.core.windows.net",
            "endpointDetails": [
              {
                "port": 443
              }
            ]
          }
        ],
        "provisioningState": "Succeeded"
      }
    }
  ]
}

Определения

CloudError	Ответ об ошибке из Kusto.
CloudErrorBody	Ответ об ошибке из Kusto.
EndpointDependency	Доменное имя, по которому достигается служба, включая сведения о текущем состоянии подключения.
EndpointDetail	Текущие сведения о подключении TCP из кластера Kusto к одной конечной точке.
OutboundNetworkDependenciesEndpoint	Конечные точки, к которым осуществляется доступ для общей цели, к которой Kusto среде службы требуется исходящий сетевой доступ.
OutboundNetworkDependenciesEndpointListResult	Коллекция конечных точек исходящей среды
ProvisioningState	Подготовленное состояние ресурса.

CloudError

Ответ об ошибке из Kusto.

Name	Type	Description
error	CloudErrorBody	Ответ об ошибке из Kusto.

CloudErrorBody

Ответ об ошибке из Kusto.

Name	Type	Description
code	string	Идентификатор ошибки. Коды инвариантны и предназначены для программного использования.
details	CloudErrorBody[]	Список дополнительных сведений об ошибке.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target	string	Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

EndpointDependency

Доменное имя, по которому достигается служба, включая сведения о текущем состоянии подключения.

Name	Type	Description
domainName	string	Доменное имя зависимости.
endpointDetails	EndpointDetail[]	Порты, используемые при подключении к DomainName.

EndpointDetail

Текущие сведения о подключении TCP из кластера Kusto к одной конечной точке.

Name	Type	Description
port	integer	Порт, к которому подключена конечная точка.

OutboundNetworkDependenciesEndpoint

Конечные точки, к которым осуществляется доступ для общей цели, к которой Kusto среде службы требуется исходящий сетевой доступ.

Name	Type	Description
etag	string	Уникальная строка только для чтения, которая изменяется при каждом обновлении ресурса.
id	string	Полный идентификатор ресурса. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Имя ресурса.
properties.category	string	Тип службы, к которой обращается среда службы Kusto, например служба хранилища Azure, База данных SQL Azure и Azure Active Directory.
properties.endpoints	EndpointDependency[]	Конечные точки, по которым среда службы Kusto достигает службы.
properties.provisioningState	ProvisioningState	Подготовленное состояние ресурса.
type	string	Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft. служба хранилища/storageAccounts"

OutboundNetworkDependenciesEndpointListResult

Коллекция конечных точек исходящей среды

Name	Type	Description
nextLink	string	Ссылка на следующую страницу ресурсов.
value	OutboundNetworkDependenciesEndpoint[]	Коллекция ресурсов.

ProvisioningState

Подготовленное состояние ресурса.

Name	Type	Description
Creating	string
Deleting	string
Failed	string
Moving	string
Running	string
Succeeded	string