Een lijst met selfservicebeleidsregels ophalen
Hiermee haalt u een verzameling resources op die selfservicebeleid voor een entiteit vertegenwoordigt.
Vereisten
- Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met Application+User-referenties.
C#
Een lijst met alle selfservicebeleidsregels ophalen:
- Roep de methode IAggregatePartner.With(IRequestContext) aan met de entiteits-id om een interface op te halen voor bewerkingen in het beleid.
// IAggregatePartner partnerOperations;
// All the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));
// gets the self-serve policies
var SelfServePolicies = scopedPartnerOperations.SelfServePolicies.Get(customerIdAsEntity);
Zie het volgende voor een voorbeeld:
- Voorbeeld: Console-test-app
- Project: PartnerSDk.FeatureSamples
- Klasse: GetSelfServePolicies.cs
REST-aanvraag
Aanvraagsyntaxis
Methode | Aanvraag-URI |
---|---|
GET | {baseURL}/v1/SelfServePolicy?entity_id={entity_id} HTTP/1.1 |
URI-parameter
Gebruik de volgende queryparameter om een lijst met klanten op te halen.
Naam | Type | Vereist | Beschrijving |
---|---|---|---|
entity_id | tekenreeks | J | De entiteits-id waarvoor toegang wordt aangevraagd. Dit is de tenant-id van de klant. |
Aanvraagheaders
Zie Kopteksten voor meer informatie.
Aanvraagbody
Geen.
Voorbeeld van aanvraag
GET https://api.partnercenter.microsoft.com/v1/SelfServePolicy?entity_id=00aa00aa-bb11-cc22-dd33-44ee44ee44ee HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
REST-antwoord
Als dit lukt, retourneert deze methode een verzameling SelfServePolicy-resources in de hoofdtekst van het antwoord.
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 Foutcodes voor een volledige lijst.
Voorbeeld van antwoord
HTTP/1.1 200 OK
Content-Length: 15650
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
Date: Fri, 20 Nov 2015 01:08:23 GMT
{
"totalCount": 1,
"items": [{
"id": "634f6379-ad54-449b-9821-564f737158ab_0431a72c-7d8a-4393-b25e-ef63f5efb415",
"selfServeEntity": {
"selfServeEntityType": "customer",
"tenantID": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
},
"grantor": {
"grantorType": "billToPartner",
"tenantID": "bbbbcccc-1111-dddd-2222-eeee3333ffff"
},
"permissions": [
{
"resource": "AzureReservedInstances",
"action": "Purchase"
},
{
"resource": "AzureSavingsPlan",
"action": "Purchase"
}
],
"attributes": {
"etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
"objectType": "SelfServePolicy"
}
}],
"attributes": {
"objectType": "Collection"
}
}