Aktualisieren einer SelfServePolicy

Artikel
03/19/2024

In diesem Artikel wird erläutert, wie Sie eine Self-Service-Richtlinie aktualisieren.

Voraussetzungen

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

C#

So aktualisieren Sie eine Self-Service-Richtlinie:

Rufen Sie die IAggregatePartner.SelfServePolicies.ById-Methode mit dem Entitätsbezeichner auf, um eine Schnittstelle zu Vorgängen für die Richtlinien abzurufen.
Rufen Sie die Put - oder PutAsync-Methode auf, um die Self-Service-Richtlinie zu aktualisieren.

// IAggregatePartner partnerOperations;
SelfServePolicy policy;

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

// updates the self-serve policies
partnerOperations.SelfServePolicies.ById(policy.id).Put(policy);

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
PUT	{baseURL}/v1/SelfServePolicy HTTP/1.1

Anforderungsheader

Ein Anforderungsbezeichner und ein Korrelationsbezeichner sind erforderlich.
Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

In dieser Tabelle werden die erforderlichen Eigenschaften im Anforderungstext beschrieben.

Name	Typ	BESCHREIBUNG
SelfServePolicy	Objekt (object)	Die Self-Service-Richtlinieninformationen.

SelfServePolicy

In dieser Tabelle werden die mindestens erforderlichen Felder aus der SelfServePolicy-Ressource beschrieben, die zum Erstellen einer neuen Self-Service-Richtlinie erforderlich sind.

Eigenschaft	Typ	BESCHREIBUNG
id	Zeichenfolge	Ein Self-Service-Richtlinienbezeichner, der bei erfolgreicher Erstellung der Self-Service-Richtlinie bereitgestellt wird.
SelfServeEntity	SelfServeEntity	Die Self-Service-Entität, der Zugriff gewährt wird.
Grantor	Grantor	Der Empfänger, der Zugriff gewährt.
Berechtigungen	Ein Array von Permission	Ein Array von Berechtigungsressourcen .
ETag	Zeichenfolge	Das Etag.

Anforderungsbeispiel

PUT https://api.partnercenter.microsoft.com/v1/SelfServePolicy HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

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

REST-Antwort

Bei erfolgreicher Ausführung gibt diese API eine SelfServePolicy-Ressource für die aktualisierte Self-Service-Richtlinie 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. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Diese Methode gibt die folgenden Fehlercodes zurück:

HTTP-Statuscode	Fehlercode	BESCHREIBUNG
404	600039	Die Self-Service-Richtlinie wurde nicht gefunden.
404	600040	Der Self-Service-Richtlinienbezeichner ist falsch.

Antwortbeispiel

HTTP/1.1 200 Ok
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
Date: Tue, 14 Feb 2017 20:06:02 GMT

{
    "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": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
        "objectType": "SelfServePolicy"
    }
}

Share via