Outbound Endpoints - Get

Dienst:

DNS

API-Version:

2025-05-01

Ruft Eigenschaften eines ausgehenden Endpunkts für einen DNS-Resolver ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsResolvers/{dnsResolverName}/outboundEndpoints/{outboundEndpointName}?api-version=2025-05-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dnsResolverName	path	True	string	Der Name des DNS-Resolvers.
outboundEndpointName	path	True	string	Der Name des ausgehenden Endpunkts für den DNS-Resolver.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	OutboundEndpoint	Der ausgehende Endpunkt für den DNS-Resolver wurde gefunden.
Other Status Codes	CloudError	Standardantwort. Sie wird gemäß der Fehlerdefinition deserialisiert.

Beispiele

Retrieve outbound endpoint for DNS resolver

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint?api-version=2025-05-01

Java

/**
 * Samples for OutboundEndpoints Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/OutboundEndpoint_Get.json
     */
    /**
     * Sample code: Retrieve outbound endpoint for DNS resolver.
     * 
     * @param manager Entry point to DnsResolverManager.
     */
    public static void
        retrieveOutboundEndpointForDNSResolver(com.azure.resourcemanager.dnsresolver.DnsResolverManager manager) {
        manager.outboundEndpoints().getWithResponse("sampleResourceGroup", "sampleDnsResolver",
            "sampleOutboundEndpoint", 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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.dnsresolver import DnsResolverManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-dnsresolver
# USAGE
    python outbound_endpoint_get.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 = DnsResolverManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="abdd4249-9f34-4cc6-8e42-c2e32110603e",
    )

    response = client.outbound_endpoints.get(
        resource_group_name="sampleResourceGroup",
        dns_resolver_name="sampleDnsResolver",
        outbound_endpoint_name="sampleOutboundEndpoint",
    )
    print(response)


# x-ms-original-file: specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/OutboundEndpoint_Get.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

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/outboundEndpoints/sampleOutboundEndpoint",
  "name": "sampleOutboundEndpoint",
  "type": "Microsoft.Network/dnsResolvers/outboundEndpoints",
  "tags": {
    "key1": "value1"
  },
  "location": "westus2",
  "etag": "00000000-0000-0000-0000-000000000000",
  "systemData": {
    "createdByType": "Application",
    "createdAt": "2021-04-01T01:01:01.1075056Z",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2021-04-02T02:03:01.1974346Z"
  },
  "properties": {
    "subnet": {
      "id": "/subscriptions/0403cfa9-9659-4f33-9f30-1f191c51d111/resourceGroups/sampleVnetResourceGroupName/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork/subnets/sampleSubnet"
    },
    "provisioningState": "Succecced",
    "resourceGuid": "b4d35f41-0c70-4ec7-bb3e-0cd9f8b7e4be"
  }
}

Definitionen

Name	Beschreibung
CloudError	Fehlermeldung
CloudErrorBody	Der Textkörper einer Fehlermeldung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
OutboundEndpoint	Beschreibt einen ausgehenden Endpunkt für einen DNS-Resolver.
ProvisioningState	Der aktuelle Bereitstellungsstatus der Ressource.
SubResource	Verweisen Sie auf eine andere ARM-Ressource.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

CloudError

Objekt

Fehlermeldung

Name	Typ	Beschreibung
error	CloudErrorBody	Der Textkörper der Fehlermeldung

CloudErrorBody

Objekt

Der Textkörper einer Fehlermeldung

Name	Typ	Beschreibung
code	string	Der Fehlercode
details	CloudErrorBody[]	Zusätzliche Fehlerinformationen
message	string	Eine Beschreibung, was den Fehler verursacht hat
target	string	Die Zielressource der Fehlermeldung

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

OutboundEndpoint

Objekt

Beschreibt einen ausgehenden Endpunkt für einen DNS-Resolver.

Name	Typ	Beschreibung
etag	string	ETag des ausgehenden Endpunkts.
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.provisioningState	ProvisioningState	Der aktuelle Bereitstellungsstatus des ausgehenden Endpunkts. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.
properties.resourceGuid	string	Die resourceGuid-Eigenschaft der ausgehenden Endpunktressource.
properties.subnet	SubResource	Der Verweis auf das Subnetz, das für den ausgehenden Endpunkt verwendet wird.
systemData	systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ProvisioningState

Enumeration

Der aktuelle Bereitstellungsstatus der Ressource.

Wert	Beschreibung
Canceled
Creating
Deleting
Failed
Succeeded
Updating

SubResource

Objekt

Verweisen Sie auf eine andere ARM-Ressource.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.