Een SelfServePolicy bijwerken

  • Artikel

In dit artikel wordt uitgelegd hoe u een selfservicebeleid bijwerkt.

Vereisten

  • Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met Application+User-referenties.

C#

Een beleid voor zelfbediening bijwerken:

  1. Roep de methode IAggregatePartner.SelfServePolicies.ById aan met de entiteits-id om een interface op te halen voor bewerkingen in het beleid.

  2. Roep de methode Put of PutAsync aan om het selfservicebeleid bij te werken.

// 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-aanvraag

Aanvraagsyntaxis

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

Aanvraagheaders

Aanvraagbody

In deze tabel worden de vereiste eigenschappen in de aanvraagtekst beschreven.

Naam Type Beschrijving
SelfServePolicy object De beleidsinformatie voor selfservice.

SelfServePolicy

In deze tabel worden de minimaal vereiste velden van de SelfServePolicy-resource beschreven die nodig zijn om een nieuw selfservicebeleid te maken.

Eigenschap Type Beschrijving
id tekenreeks Een selfservicebeleids-id die wordt opgegeven bij het maken van het selfservicebeleid.
SelfServeEntity SelfServeEntity De selfservice-entiteit die toegang krijgt.
Grantor Grantor De grantor die toegang verleent.
Machtigingen Machtigingsmatrix Een matrix van machtigingsresources .
Etag tekenreeks De Etag.

Voorbeeld van aanvraag

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

Als dit lukt, retourneert deze API een SelfServePolicy-resource voor het bijgewerkte selfservicebeleid.

Geslaagde en foutcodes voor antwoorden

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het is gelukt of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partner Center REST-foutcodes voor de volledige lijst.

Deze methode retourneert de volgende foutcodes:

HTTP-statuscode Foutcode Beschrijving
404 600039 Zelfbedieningsbeleid is niet gevonden
404 600040 Zelfservicebeleids-id is onjuist

Voorbeeld van antwoord

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