Origins - List By Endpoint

Dienst:: CDN

API-Version:: 2025-04-15

Listet alle vorhandenen Ursprünge innerhalb eines Endpunkts auf.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpointName	path	True	string	Name des Endpunkts unter dem Profil, das global eindeutig ist.
profileName	path	True	string	Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.
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	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	OriginListResult	OKAY. Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	CDN-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

Origins_ListByEndpoint

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins?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/Origins_ListByEndpoint.json
// this example is just showing the usage of "CdnOrigins_ListByEndpoint" 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 CdnEndpointResource created on azure
// for more information of creating CdnEndpointResource, please refer to the document of CdnEndpointResource
string subscriptionId = "subid";
string resourceGroupName = "RG";
string profileName = "profile1";
string endpointName = "endpoint1";
ResourceIdentifier cdnEndpointResourceId = CdnEndpointResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, profileName, endpointName);
CdnEndpointResource cdnEndpoint = client.GetCdnEndpointResource(cdnEndpointResourceId);

// get the collection of this CdnOriginResource
CdnOriginCollection collection = cdnEndpoint.GetCdnOrigins();

// invoke the operation and iterate over the result
await foreach (CdnOriginResource 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
    CdnOriginData 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

Beispiel für eine Antwort

Statuscode:: 200

{
  "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"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
Origin	DER CDN-Ursprung ist die Quelle der Inhalte, die über CDN übermittelt 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.
OriginListResult	Ergebnis der Anforderung zum Auflisten von Ursprüngen. Sie enthält eine Liste von Ursprungsobjekten und einen URL-Link, um den nächsten Satz von Ergebnissen abzurufen.
OriginProvisioningState	Bereitstellungsstatus des Ursprungs.
OriginResourceState	Ressourcenstatus des Ursprungs.
PrivateEndpointStatus	Der Genehmigungsstatus für die Verbindung mit dem privaten Link
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

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.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

Origin

Objekt

DER CDN-Ursprung ist die Quelle der Inhalte, die über CDN übermittelt 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	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties.enabled	boolean	Der Ursprung ist für den Lastenausgleich aktiviert oder nicht.
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	Der Wert des HTTP-Ports. Muss zwischen 1 und 65535 sein.
properties.httpsPort	integer (int32) minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	Der Wert des HTTPS-Ports. Muss zwischen 1 und 65535 sein.
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 CDN-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.privateEndpointStatus	PrivateEndpointStatus	Der Genehmigungsstatus für die Verbindung mit dem privaten Link
properties.privateLinkAlias	string	Der Alias der Ressource für private Verknüpfungen. Wenn Sie dieses optionale Feld auffüllen, wird angegeben, dass dieser Ursprung "Privat" ist.
properties.privateLinkApprovalMessage	string	Eine benutzerdefinierte Nachricht, die in die Genehmigungsanforderung aufgenommen werden soll, um eine Verbindung mit dem privaten Link herzustellen.
properties.privateLinkLocation	string	Der Speicherort der Ressource für private Verknüpfungen. Nur erforderlich, wenn "privateLinkResourceId" aufgefüllt wird
properties.privateLinkResourceId	string	Die Ressourcen-ID der Ressource "Private Verknüpfung". Wenn Sie dieses optionale Feld auffüllen, wird angegeben, dass dieses Back-End "Privat" ist.
properties.provisioningState	OriginProvisioningState	Bereitstellungsstatus des Ursprungs.
properties.resourceState	OriginResourceState	Ressourcenstatus des Ursprungs.
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	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

OriginListResult

Objekt

Ergebnis der Anforderung zum Auflisten von Ursprüngen. Sie enthält eine Liste von Ursprungsobjekten und einen URL-Link, um den nächsten Satz von Ergebnissen abzurufen.

Name	Typ	Beschreibung
nextLink	string	URL, um den nächsten Satz von Ursprungsobjekten abzurufen, falls vorhanden.
value	Origin[]	Liste der CDN-Ursprünge innerhalb eines Endpunkts

OriginProvisioningState

Enumeration

Bereitstellungsstatus des Ursprungs.

Wert	Beschreibung
Creating
Deleting
Failed
Succeeded
Updating

OriginResourceState

Enumeration

Ressourcenstatus des Ursprungs.

Wert	Beschreibung
Active
Creating
Deleting

PrivateEndpointStatus

Enumeration

Der Genehmigungsstatus für die Verbindung mit dem privaten Link

Wert	Beschreibung
Approved
Disconnected
Pending
Rejected
Timeout

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.

Freigeben über

Origins - List By Endpoint

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Origins_ListByEndpoint

Beispielanforderung

Beispiel für eine Antwort

Definitionen

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Origin

OriginListResult

OriginProvisioningState

OriginResourceState

PrivateEndpointStatus

systemData