Obtenir la liste des stratégies en libre-service

Article
10/26/2023

Obtient une collection de ressources qui représente des stratégies libre-service pour une entité.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification Application+Utilisateur.

C#

Pour obtenir la liste de toutes les stratégies en libre-service :

Appelez la méthode IAggregatePartner.With(IRequestContext) avec l’identificateur d’entité pour récupérer une interface aux opérations sur les stratégies.

// 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 éléments suivants :

Exemple : Application de test de console
Projet : PartnerSDK.FeatureSamples
Classe : GetSelfServePolicies.cs

Demande REST

Syntaxe de la requête

Méthode	URI de requête
GET	{baseURL}/v1/SelfServePolicy?entity_id={entity_id} HTTP/1.1

Paramètre d’URI

Utilisez le paramètre de requête suivant pour obtenir la liste des clients.

Nom	Type	Obligatoire	Description
entity_id	string	O	Identificateur d’entité pour laquelle l’accès est demandé. Il s’agit de l’ID de locataire du client.

En-têtes de requête

Pour plus d’informations, consultez En-têtes.

Corps de la demande

Aucun.

Exemple de requête

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 REST

Si elle réussit, cette méthode renvoie une collection de ressources SelfServePolicy dans le corps de la réponse.

Codes d’erreur et de réussite de la réponse

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. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

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"
    }
}