Uppdatera en SelfServePolicy

Artikel
03/19/2024

Den här artikeln förklarar hur du uppdaterar en självbetjäningsprincip.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med autentiseringsuppgifter för program+användare.

C#

Så här uppdaterar du en självbetjäningsprincip:

Anropa metoden IAggregatePartner.SelfServePolicies.ById med entitetsidentifieraren för att hämta ett gränssnitt för åtgärder på principerna.
Anropa metoden Put eller PutAsync för att uppdatera självbetjäningsprincipen.

// 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-begäran

Begärandesyntax

Metod	URI för förfrågan
PUT	{baseURL}/v1/SelfServePolicy HTTP/1.1

Begärandehuvuden

En begärandeidentifierare och korrelationsidentifierare krävs.
Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

I den här tabellen beskrivs de obligatoriska egenskaperna i begärandetexten.

Namn	Typ	Description
SelfServePolicy	objekt	Principinformation för självbetjäning.

SelfServePolicy

I den här tabellen beskrivs de minsta obligatoriska fälten från den SelfServePolicy-resurs som behövs för att skapa en ny självbetjäningsprincip.

Egenskap	Typ	Description
id	sträng	En principidentifierare för självbetjäning som tillhandahålls när självbetjäningsprincipen har skapats.
SelfServeEntity	SelfServeEntity	Självbetjäningsentiteten som beviljas åtkomst.
Beviljaren	Beviljaren	Den beviljare som beviljar åtkomst.
Behörigheter	Matris med behörigheter	En matris med behörighetsresurser .
Etag	sträng	The Etag.

Exempel på begäran

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-svar

Om det lyckas returnerar det här API:et en SelfServePolicy-resurs för den uppdaterade självbetjäningsprincipen.

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.

Den här metoden returnerar följande felkoder:

HTTP-statuskod	Felkod	Beskrivning
404	600039	Självbetjäningsprincipen hittades inte
404	600040	Principidentifieraren för självbetjäning är felaktig

Exempel på svar

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

Dela via