AFD Endpoints - List By Profile

Serviço:: Front Door Service

Versão da API:: 2025-04-15

Lista os pontos de extremidade existentes do AzureFrontDoor.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints?api-version=2025-04-15

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	Nome do Azure Front Door Standard ou Azure Front Door Premium que é exclusivo dentro do grupo de recursos.
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	AFDEndpointListResult	OK
Other Status Codes	ErrorResponse	Resposta de erro do Azure Front Door descrevendo por que a operação falhou.

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

AFDEndpoints_ListByProfile

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdEndpoints?api-version=2025-04-15

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

// Generated from example definition: specification/cdn/resource-manager/Microsoft.Cdn/stable/2025-04-15/examples/AFDEndpoints_ListByProfile.json
// this example is just showing the usage of "FrontDoorEndpoints_ListByProfile" 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 ProfileResource created on azure
// for more information of creating ProfileResource, please refer to the document of ProfileResource
string subscriptionId = "subid";
string resourceGroupName = "RG";
string profileName = "profile1";
ResourceIdentifier profileResourceId = ProfileResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, profileName);
ProfileResource profile = client.GetProfileResource(profileResourceId);

// get the collection of this FrontDoorEndpointResource
FrontDoorEndpointCollection collection = profile.GetFrontDoorEndpoints();

// invoke the operation and iterate over the result
await foreach (FrontDoorEndpointResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    FrontDoorEndpointData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

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

Resposta da amostra

Código de estado:: 200

{
  "value": [
    {
      "name": "endpoint1",
      "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdendpoints/endpoint1",
      "type": "Microsoft.Cdn/profiles/afdendpoints",
      "tags": {},
      "location": "global",
      "properties": {
        "hostName": "endpoint1-abcdefghijklmnop.z01.azurefd.net",
        "enabledState": "Enabled",
        "provisioningState": "Succeeded",
        "deploymentStatus": "NotStarted",
        "autoGeneratedDomainNameLabelScope": "TenantReuse"
      }
    }
  ]
}

Definições

Name	Description
AFDEndpoint	O ponto de extremidade do Azure Front Door é a entidade dentro de um perfil do Azure Front Door que contém informações de configuração, como origem, protocolo, cache de conteúdo e comportamento de entrega. O ponto de extremidade AzureFrontDoor usa o formato de URL .azureedge.net.
AFDEndpointListResult	Resultado da solicitação para listar pontos de extremidade. Ele contém uma lista de objetos de ponto de extremidade e um link de URL para obter o próximo conjunto de resultados.
AfdProvisioningState	Status de provisionamento
AutoGeneratedDomainNameLabelScope	Indica o escopo de reutilização do nome do ponto de extremidade. O valor padrão é TenantReuse.
createdByType	O tipo de identidade que criou o recurso.
DeploymentStatus
EnabledState	Se deve ou não permitir o uso desta regra. Os valores permitidos são 'Ativado' ou 'Desativado'
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
systemData	Metadados referentes à criação e última modificação do recurso.

AFDEndpoint

Object

O ponto de extremidade do Azure Front Door é a entidade dentro de um perfil do Azure Front Door que contém informações de configuração, como origem, protocolo, cache de conteúdo e comportamento de entrega. O ponto de extremidade AzureFrontDoor usa o formato de URL .azureedge.net.

Name	Tipo	Description
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.autoGeneratedDomainNameLabelScope	AutoGeneratedDomainNameLabelScope	Indica o escopo de reutilização do nome do ponto de extremidade. O valor padrão é TenantReuse.
properties.deploymentStatus	DeploymentStatus
properties.enabledState	EnabledState	Se deve ou não permitir o uso desta regra. Os valores permitidos são 'Ativado' ou 'Desativado'
properties.hostName	string	O nome do host do ponto de extremidade estruturado como {endpointName}. {DNSZone}, por exemplo, contoso.azureedge.net
properties.profileName	string	O nome do perfil que contém o ponto de extremidade.
properties.provisioningState	AfdProvisioningState	Status de provisionamento
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"

AFDEndpointListResult

Object

Resultado da solicitação para listar pontos de extremidade. Ele contém uma lista de objetos de ponto de extremidade e um link de URL para obter o próximo conjunto de resultados.

Name	Tipo	Description
nextLink	string	URL para obter o próximo conjunto de objetos de ponto de extremidade, se houver.
value	AFDEndpoint[]	Lista de pontos de extremidade do AzureFrontDoor dentro de um perfil

AfdProvisioningState

Enumeração

Status de provisionamento

Valor	Description
Creating
Deleting
Failed
Succeeded
Updating

AutoGeneratedDomainNameLabelScope

Enumeração

Indica o escopo de reutilização do nome do ponto de extremidade. O valor padrão é TenantReuse.

Valor	Description
NoReuse
ResourceGroupReuse
SubscriptionReuse
TenantReuse

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

DeploymentStatus

Enumeração

Valor	Description
Failed
InProgress
NotStarted
Succeeded

EnabledState

Enumeração

Se deve ou não permitir o uso desta regra. Os valores permitidos são 'Ativado' ou 'Desativado'

Valor	Description
Disabled
Enabled

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

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.

Partilhar via

AFD Endpoints - List By Profile

Parâmetros do URI

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

AFDEndpoints_ListByProfile

Pedido de amostra

Resposta da amostra

Definições

AFDEndpoint

AFDEndpointListResult

AfdProvisioningState

AutoGeneratedDomainNameLabelScope

createdByType

DeploymentStatus

EnabledState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

systemData