Een SelfServePolicy bijwerken
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:
Roep de methode IAggregatePartner.SelfServePolicies.ById aan met de entiteits-id om een interface op te halen voor bewerkingen in het beleid.
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
- Een aanvraag-id en correlatie-id zijn vereist.
- Zie Rest-headers van partnercentrum voor meer informatie.
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"
}
}