Freigeben über


AFD Origins - Get

Ruft einen vorhandenen Ursprung innerhalb einer Ursprungsgruppe ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
originGroupName
path True

string

Name der Ursprungsgruppe, die innerhalb des Profils eindeutig ist.

originName
path True

string

Der Name des Ursprungs, der innerhalb des Profils eindeutig ist.

profileName
path True

string

minLength: 1
maxLength: 260
pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

Name des Azure Front Door Standard oder Azure Front Door Premium, der innerhalb der Ressourcengruppe eindeutig ist.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Name der Ressourcengruppe innerhalb des Azure-Abonnements.

subscriptionId
path True

string

Azure-Abonnement-ID.

api-version
query True

string

Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2025-04-15.

Antworten

Name Typ Beschreibung
200 OK

AFDOrigin

OKAY

Other Status Codes

AfdErrorResponse

Azure Front Door-Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

AFDOrigins_Get

Beispielanforderung

GET https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/origingroup1/origins/origin1?api-version=2025-04-15

Beispiel für eine Antwort

{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/origingroups/origingroup1/origins/origin1",
  "type": "Microsoft.Cdn/profiles/origingroups/origins",
  "name": "origin1",
  "properties": {
    "hostName": "host1.blob.core.windows.net",
    "httpPort": 80,
    "httpsPort": 443,
    "originHostHeader": "host1.foo.com",
    "priority": null,
    "weight": null,
    "enabledState": "Enabled",
    "provisioningState": "Succeeded",
    "deploymentStatus": "NotStarted",
    "originGroupName": "origingroup1",
    "sharedPrivateLinkResource": null,
    "enforceCertificateNameCheck": true
  }
}

Definitionen

Name Beschreibung
AfdErrorResponse

Fehlerantwort

AFDOrigin

Der Ursprung von Azure Front Door ist die Quelle der Inhalte, die über Azure Front Door bereitgestellt werden. Wenn die durch einen Endpunkt dargestellten Edgeknoten nicht über den angeforderten Inhalt zwischengespeichert wurden, versuchen sie, sie aus einem oder mehreren der konfigurierten Ursprünge abzurufen.

AfdProvisioningState

Bereitstellungsstatus

DeploymentStatus
EnabledState

Gibt an, ob die Verwendung dieser Regel aktiviert werden soll. Zulässige Werte sind "Enabled" oder "Disabled"

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

IdentityType

Der Identitätstyp, der Ressourcen erstellt/ändert

ResourceReference

Verweisen auf eine andere Ressource.

SharedPrivateLinkResourceProperties

Beschreibt die Eigenschaften einer vorhandenen ressource für freigegebene private Verknüpfungen, die beim Herstellen einer Verbindung mit einem privaten Ursprung verwendet werden soll.

SharedPrivateLinkResourceStatus

Status der freigegebenen privaten Linkressource. Kann ausstehend, genehmigt, abgelehnt, getrennt oder Timeout sein.

SystemData

Schreibgeschützte Systemdaten

AfdErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

AFDOrigin

Der Ursprung von Azure Front Door ist die Quelle der Inhalte, die über Azure Front Door bereitgestellt werden. Wenn die durch einen Endpunkt dargestellten Edgeknoten nicht über den angeforderten Inhalt zwischengespeichert wurden, versuchen sie, sie aus einem oder mehreren der konfigurierten Ursprünge abzurufen.

Name Typ Standardwert Beschreibung
id

string

Ressourcen-ID.

name

string

Ressourcenname.

properties.azureOrigin

ResourceReference

Ressourcenverweis auf die Azure-Ursprungsressource.

properties.deploymentStatus

DeploymentStatus

properties.enabledState

EnabledState

Gibt an, ob Integritätsüberprüfungen für Back-End-Dateien aktiviert werden sollen, die unter back-EndPools definiert sind. Integritätssonden können nur deaktiviert werden, wenn ein einzelnes aktiviertes Back-End in einem einzigen aktivierten Back-End-Pool vorhanden ist.

properties.enforceCertificateNameCheck

boolean

True

Gibt an, ob die Zertifikatnamenüberprüfung auf Ursprungsebene aktiviert werden soll

properties.hostName

string

Die Adresse des Ursprungs. Domänennamen, IPv4-Adressen und IPv6-Adressen werden unterstützt. Dies sollte für alle Ursprünge eines Endpunkts eindeutig sein.

properties.httpPort

integer (int32)

minimum: 1
maximum: 65535
exclusiveMinimum: False
exclusiveMaximum: False
80

Der Wert des HTTP-Ports. Muss zwischen 1 und 65535 sein.

properties.httpsPort

integer (int32)

minimum: 1
maximum: 65535
exclusiveMinimum: False
exclusiveMaximum: False
443

Der Wert des HTTPS-Ports. Muss zwischen 1 und 65535 sein.

properties.originGroupName

string

Der Name der Ursprungsgruppe, die diesen Ursprung enthält.

properties.originHostHeader

string

Der Hostheaderwert, der mit jeder Anforderung an den Ursprung gesendet wird. Wenn Sie diesen Wert leer lassen, bestimmt der Anforderungshost diesen Wert. Azure Front Door-Ursprünge, z. B. Web Apps, Blob Storage und Cloud Services, erfordern diesen Hostheaderwert, um standardmäßig mit dem Ursprungshostnamen übereinzugleichen. Dadurch wird der am Endpunkt definierte Hostheader außer Kraft gesetzt.

properties.priority

integer (int32)

minimum: 1
maximum: 5

Priorität des Ursprungs in der angegebenen Ursprungsgruppe für den Lastenausgleich. Höhere Prioritäten werden nicht für den Lastenausgleich verwendet, wenn ein Ursprung mit niedrigerer Priorität fehlerfrei ist. Muss zwischen 1 und 5 sein

properties.provisioningState

AfdProvisioningState

Bereitstellungsstatus

properties.sharedPrivateLinkResource

SharedPrivateLinkResourceProperties

Die Eigenschaften der privaten Verknüpfungsressource für den privaten Ursprung.

properties.weight

integer (int32)

minimum: 1
maximum: 1000

Gewichtung des Ursprungs in der angegebenen Ursprungsgruppe für den Lastenausgleich. Muss zwischen 1 und 1000 sein

systemData

SystemData

Schreibgeschützte Systemdaten

type

string

Ressourcentyp.

AfdProvisioningState

Bereitstellungsstatus

Wert Beschreibung
Creating
Deleting
Failed
Succeeded
Updating

DeploymentStatus

Wert Beschreibung
Failed
InProgress
NotStarted
Succeeded

EnabledState

Gibt an, ob die Verwendung dieser Regel aktiviert werden soll. Zulässige Werte sind "Enabled" oder "Disabled"

Wert Beschreibung
Disabled
Enabled

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

IdentityType

Der Identitätstyp, der Ressourcen erstellt/ändert

Wert Beschreibung
application
key
managedIdentity
user

ResourceReference

Verweisen auf eine andere Ressource.

Name Typ Beschreibung
id

string

Ressourcen-ID.

SharedPrivateLinkResourceProperties

Beschreibt die Eigenschaften einer vorhandenen ressource für freigegebene private Verknüpfungen, die beim Herstellen einer Verbindung mit einem privaten Ursprung verwendet werden soll.

Name Typ Beschreibung
groupId

string

Die Gruppen-ID vom Anbieter der Ressource, für die die freigegebene private Linkressource gilt.

privateLink

ResourceReference

Die Ressourcen-ID der Ressource, für die die freigegebene private Verknüpfungsressource gilt.

privateLinkLocation

string

Der Speicherort der freigegebenen ressource für private Verknüpfungen

requestMessage

string

Die Anforderungsnachricht zum Anfordern der Genehmigung der Ressource für freigegebene private Links.

status

SharedPrivateLinkResourceStatus

Status der freigegebenen privaten Linkressource. Kann ausstehend, genehmigt, abgelehnt, getrennt oder Timeout sein.

SharedPrivateLinkResourceStatus

Status der freigegebenen privaten Linkressource. Kann ausstehend, genehmigt, abgelehnt, getrennt oder Timeout sein.

Wert Beschreibung
Approved
Disconnected
Pending
Rejected
Timeout

SystemData

Schreibgeschützte Systemdaten

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC)

createdBy

string

Ein Bezeichner für die Identität, die die Ressource erstellt hat

createdByType

IdentityType

Der Identitätstyp, der die Ressource erstellt hat

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Ein Bezeichner für die Identität, die die Ressource zuletzt geändert hat

lastModifiedByType

IdentityType

Der Identitätstyp, der die Ressource zuletzt geändert hat