Partilhar via


Origins - List By Endpoint

Listas todas as origens existentes num ponto final.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins?api-version=2024-02-01

Parâmetros do URI

Name Em Necessário Tipo Description
endpointName
path True

string

Nome do ponto final no perfil que é exclusivo globalmente.

profileName
path True

string

Nome do perfil da CDN que é exclusivo no grupo de recursos.

resourceGroupName
path True

string

Nome do Grupo de recursos na subscrição do Azure.

Padrão Regex: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID da Subscrição do Azure.

api-version
query True

string

Versão da API a utilizar com o pedido de cliente. A versão atual é 2024-02-01.

Respostas

Name Tipo Description
200 OK

OriginListResult

OK. O pedido foi efetuada com êxito.

Other Status Codes

ErrorResponse

Resposta de erro da CDN que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Origins_ListByEndpoint

Pedido de amostra

GET https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins?api-version=2024-02-01

Resposta da amostra

{
  "value": [
    {
      "name": "www-someDomain-net",
      "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
      "type": "Microsoft.Cdn/profiles/endpoints/origins",
      "properties": {
        "provisioningState": "Succeeded",
        "resourceState": "Active",
        "hostName": "www.someDomain.net",
        "httpPort": null,
        "httpsPort": null,
        "originHostHeader": "www.someDomain.net",
        "priority": 1,
        "weight": 50,
        "enabled": true,
        "privateEndpointStatus": "Pending",
        "privateLinkApprovalMessage": "Please approve the connection request for this Private Link",
        "privateLinkAlias": "APPSERVER.d84e61f0-0870-4d24-9746-7438fa0019d1.westus2.azure.privatelinkservice"
      }
    }
  ]
}

Definições

Name Description
ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

IdentityType

O tipo de identidade que cria/modifica recursos

Origin

A origem da CDN é a origem do conteúdo que está a ser entregue através da CDN. Quando os nós de extremidade representados por um ponto final não têm o conteúdo pedido em cache, tentam ocorrê-lo a partir de uma ou mais das origens configuradas.

OriginListResult

Resultado do pedido para listar origens. Contém uma lista de objetos de origem e uma ligação de URL para obter o próximo conjunto de resultados.

OriginProvisioningState

Estado de aprovisionamento da origem.

OriginResourceState

Estado do recurso da origem.

PrivateEndpointStatus

O estado de aprovação da ligação à Private Link

SystemData

Dados do sistema só de leitura

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

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

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

IdentityType

O tipo de identidade que cria/modifica recursos

Name Tipo Description
application

string

key

string

managedIdentity

string

user

string

Origin

A origem da CDN é a origem do conteúdo que está a ser entregue através da CDN. Quando os nós de extremidade representados por um ponto final não têm o conteúdo pedido em cache, tentam ocorrê-lo a partir de uma ou mais das origens configuradas.

Name Tipo Description
id

string

ID do Recurso.

name

string

Nome do recurso.

properties.enabled

boolean

A origem está ativada para balanceamento de carga ou não

properties.hostName

string

O endereço da origem. São suportados nomes de domínio, endereços IPv4 e endereços IPv6. Isto deve ser exclusivo em todas as origens num ponto final.

properties.httpPort

integer

O valor da porta HTTP. Tem de estar entre 1 e 65535.

properties.httpsPort

integer

O valor da porta HTTPS. Tem de estar entre 1 e 65535.

properties.originHostHeader

string

O valor do cabeçalho do anfitrião enviado para a origem com cada pedido. Se deixar este valor em branco, o nome do anfitrião do pedido determina este valor. As origens da CDN do Azure, como Aplicações Web, Armazenamento de Blobs e Serviços Cloud exigem que este valor de cabeçalho do anfitrião corresponda ao nome do anfitrião de origem por predefinição. Isto substitui o cabeçalho de anfitrião definido no Ponto Final

properties.priority

integer

Prioridade da origem num determinado grupo de origem para balanceamento de carga. As prioridades mais elevadas não serão utilizadas para balanceamento de carga se qualquer origem de prioridade inferior estiver em bom estado de funcionamento. Tem de estar entre 1 e 5

properties.privateEndpointStatus

PrivateEndpointStatus

O estado de aprovação da ligação à Private Link

properties.privateLinkAlias

string

O Alias do recurso Private Link. Preencher este campo opcional indica que esta origem é "Privada"

properties.privateLinkApprovalMessage

string

Uma mensagem personalizada a ser incluída no pedido de aprovação para ligar ao Private Link.

properties.privateLinkLocation

string

A localização do recurso Private Link. Necessário apenas se "privateLinkResourceId" for preenchido

properties.privateLinkResourceId

string

O ID do Recurso do recurso Private Link. Preencher este campo opcional indica que este back-end é "Privado"

properties.provisioningState

OriginProvisioningState

Estado de aprovisionamento da origem.

properties.resourceState

OriginResourceState

Estado do recurso da origem.

properties.weight

integer

Peso da origem num determinado grupo de origem para balanceamento de carga. Tem de estar entre 1 e 1000

systemData

SystemData

Dados do sistema só de leitura

type

string

Tipo de recurso.

OriginListResult

Resultado do pedido para listar origens. Contém uma lista de objetos de origem e uma ligação 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 origem, se existirem.

value

Origin[]

Lista de origens da CDN num ponto final

OriginProvisioningState

Estado de aprovisionamento da origem.

Name Tipo Description
Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

OriginResourceState

Estado do recurso da origem.

Name Tipo Description
Active

string

Creating

string

Deleting

string

PrivateEndpointStatus

O estado de aprovação da ligação à Private Link

Name Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

Timeout

string

SystemData

Dados do sistema só de leitura

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC)

createdBy

string

Um identificador para a identidade que criou o recurso

createdByType

IdentityType

O tipo de identidade que criou o recurso

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

Um identificador para a identidade que modificou o recurso pela última vez

lastModifiedByType

IdentityType

O tipo de identidade que modificou o recurso pela última vez