Outbound Endpoints - Get

Serviço:: DNS

Versão da API:: 2025-05-01

Obtém propriedades de um ponto de extremidade de saída para um resolvedor de DNS.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
dnsResolverName	path	True	string	O nome do resolvedor de DNS.
outboundEndpointName	path	True	string	O nome do ponto de extremidade de saída para o resolvedor de DNS.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	OutboundEndpoint	Operação do Azure concluída com êxito.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Retrieve outbound endpoint for DNS resolver

Pedido de amostra

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

Resposta da amostra

Código de estado:: 200

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

Definições

Name	Description
CloudError	Uma mensagem de erro
CloudErrorBody	O corpo de uma mensagem de erro
createdByType	O tipo de identidade que criou o recurso.
OutboundEndpoint	Descreve um ponto de extremidade de saída para um resolvedor de DNS.
ProvisioningState	O estado atual de provisionamento do recurso.
SubResource	Referência a outro recurso ARM.
systemData	Metadados referentes à criação e última modificação do recurso.

CloudError

Object

Uma mensagem de erro

Name	Tipo	Description
error	CloudErrorBody	O corpo da mensagem de erro

CloudErrorBody

Object

O corpo de uma mensagem de erro

Name	Tipo	Description
code	string	O código de erro
details	CloudErrorBody[]	Informações de erro adicionais
message	string	Uma descrição do que causou o erro
target	string	O recurso de destino da mensagem de erro

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

OutboundEndpoint

Object

Descreve um ponto de extremidade de saída para um resolvedor de DNS.

Name	Tipo	Description
etag	string	"Se o etag for fornecido no corpo da resposta, ele também pode ser fornecido como um cabeçalho de acordo com a convenção normal do etag. As tags de entidade são usadas para comparar duas ou mais entidades do mesmo recurso solicitado. HTTP/1.1 usa tags de entidade nos campos de cabeçalho etag (seção 14.19), If-Match (seção 14.24), If-None-Match (seção 14.26) e If-Range (seção 14.27).")
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties.provisioningState	ProvisioningState	O estado de provisionamento atual do ponto de extremidade de saída. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.
properties.resourceGuid	string	A propriedade resourceGuid do recurso de ponto de extremidade de saída.
properties.subnet	SubResource	A referência à sub-rede usada para o ponto de extremidade de saída.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ProvisioningState

Enumeração

O estado atual de provisionamento do recurso.

Valor	Description
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Object

Referência a outro recurso ARM.

Name	Tipo	Description
id	string	ID do recurso.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.