Abrufen einer Liste der Self-Service-Richtlinien

Artikel
10/26/2023

Ruft eine Auflistung von Ressourcen ab, die Self-Service-Richtlinien für eine Entität darstellt.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit Anwendungs- und Benutzeranmeldeinformationen.

C#

So rufen Sie eine Liste aller Self-Service-Richtlinien ab:

Rufen Sie die IAggregatePartner.With(IRequestContext) -Methode mit dem Entitätsbezeichner auf, um eine Schnittstelle zu Vorgängen für die Richtlinien abzurufen.

// IAggregatePartner partnerOperations;

// All the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

// gets the self-serve policies
var SelfServePolicies = scopedPartnerOperations.SelfServePolicies.Get(customerIdAsEntity);

Ein Beispiel finden Sie im Folgenden:

„Beispiel: Konsolentest der App
Projekt: PartnerSDK.FeatureSamples
Klasse: GetSelfServePolicies.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/SelfServePolicy?entity_id={entity_id} HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um eine Liste von Kunden abzurufen.

Name	Typ	Erforderlich	BESCHREIBUNG
entity_id	string	J	Der Entitätsbezeichner, der Zugriff anfordert. Dies ist die Mandanten-ID des Kunden.

Anforderungsheader

Weitere Informationen finden Sie unter Header.

Anforderungstext

Keine.

Anforderungsbeispiel

GET https://api.partnercenter.microsoft.com/v1/SelfServePolicy?entity_id=0431a72c-7d8a-4393-b25e-ef63f5efb415 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
MS-CorrelationId: b12260fb-82de-4701-a25f-dcd367690645

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Auflistung von SelfServePolicy-Ressourcen im Antworttext zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Eine vollständige Liste finden Sie unter Fehlercodes.

Antwortbeispiel

HTTP/1.1 200 OK
Content-Length: 15650
Content-Type: application/json
MS-CorrelationId: b12260fb-82de-4701-a25f-dcd367690645
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
Date: Fri, 20 Nov 2015 01:08:23 GMT

{
    "totalCount": 1,
    "items": [{
        "id": "634f6379-ad54-449b-9821-564f737158ab_0431a72c-7d8a-4393-b25e-ef63f5efb415",
        "selfServeEntity": {
            "selfServeEntityType": "customer",
            "tenantID": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
        },
        "grantor": {
            "grantorType": "billToPartner",
            "tenantID": "634f6379-ad54-449b-9821-564f737158ab"
        },
        "permissions": [
            {
                "resource": "AzureReservedInstances",
                "action": "Purchase"
            },
            {
                "resource": "AzureSavingsPlan",
                "action": "Purchase"
            }
        ],
        "attributes": {
            "etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
            "objectType": "SelfServePolicy"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}

Share via