Een lijst met selfservicebeleidsregels ophalen

Artikel
10/26/2023

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=0431a72c-7d8a-4393-b25e-ef63f5efb415 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
MS-CorrelationId: b12260fb-82de-4701-a25f-dcd367690645

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: b12260fb-82de-4701-a25f-dcd367690645
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": "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"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}

Delen via