Obtenir la liste des stratégies en libre-serviceGet a list of self-serve policies

S’applique à :Applies to:

  • Espace partenairesPartner Center

Cet article explique comment obtenir une collection de ressources qui représentent des stratégies libre-service pour une entité.This article describes how to get a collection of resources that represents self-serve policies for an entity.

PrérequisPrerequisites

C#C#

Pour obtenir la liste de toutes les stratégies libre-service :To get a list of all self-serve policies:

  1. Appelez la méthode collection iaggregatepartner. SelfServePolicies avec l’identificateur d’entité pour récupérer une interface pour les opérations sur les stratégies.Call the IAggregatePartner.SelfServePolicies method with the entity identifier to retrieve an interface to operations on the policies.
// 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);

Pour obtenir un exemple, consultez les rubriques suivantes :For an example, see the following:

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET {baseURL}/v1/SelfServePolicy ? entity_id = {ENTITY_ID} http/1.1{baseURL}/v1/SelfServePolicy?entity_id={entity_id} HTTP/1.1

Paramètre d’URIURI parameter

Utilisez le paramètre de requête suivant pour obtenir la liste des clients.Use the following query parameter to get a list of customers.

NomName TypeType ObligatoireRequired DescriptionDescription
entity_identity_id stringstring YY Identificateur d’entité demandant l’accès à.The entity identifier requesting access for. Il s’agit de l’ID de locataire du client.This will be the customer's tenant ID.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez en-têtes.For more information, see Headers.

Corps de la demandeRequest body

Aucun.None.

Exemple de requêteRequest example

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

Réponse RESTREST response

En cas de réussite, cette méthode retourne une collection de ressources SelfServePolicy dans le corps de la réponse.If successful, this method returns a collection of SelfServePolicy resources in the response body.

Codes d’erreur et de réussite de la réponseResponse success and error codes

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir une liste complète, consultez codes d’erreur.For a full list, see Error Codes.

Exemple de réponseResponse example

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"
        }],
        "attributes": {
            "etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
            "objectType": "SelfServePolicy"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}