Een SelfServePolicy bijwerken

In dit artikel wordt uitgelegd hoe u een beleid voor selfservice bijwerkt.

Vereisten

C#

Een beleid voor selfservice bijwerken:

  1. Roep de methode IAggregatePartner.SelfServePolicies.ById aan met de entiteits-id om een interface op te halen voor bewerkingen op 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

Syntaxis van aanvraag

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

Aanvraagheaders

Aanvraagbody

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

Naam Type Description
SelfServePolicy object De informatie over het zelfbedieningsbeleid.

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 zelfbedieningsentiteit die toegang krijgt.
Grantor Grantor De grantor die toegang verleent.
Machtigingen Matrix met machtigingen Een matrix met machtigingsbronnen .
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"
    }],
    "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 reacties en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie De rest-foutcodes van partnercentrum voor de volledige lijst.

Deze methode retourneert de volgende foutcodes:

HTTP-statuscode Foutcode Beschrijving
404 600039 Beleid voor zelfbediening is niet gevonden
404 600040 De id van het selfservicebeleid 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"
    }],
    "attributes": {
        "etag": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
        "objectType": "SelfServePolicy"
    }
}