Obtenir les rôles d’utilisateur d’un clientGet user roles for a customer

S’applique àApplies To

  • Espace partenairesPartner Center

Obtient la liste de tous les rôles/autorisations attachés à un compte d’utilisateur.Get a list of all the roles/permissions attached to a user account. Les variantes incluent l’obtention d’une liste de toutes les autorisations sur tous les comptes d’utilisateur pour un client et l’obtention d’une liste d’utilisateurs ayant un rôle donné.Variations include getting a list of all permissions across all user accounts for a customer, and getting a list of users that have a given role.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.This scenario supports authentication with App+User credentials only.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

C#C#

Pour récupérer tous les rôles d’annuaire pour un client spécifié, récupérez d’abord l’ID de client spécifié.To retrieve all the directory roles for a specified customer, first retrieve the specified customer ID. Ensuite, utilisez votre collection collection iaggregatepartner. Customers et appelez la méthode méthode BYID () .Then, use your IAggregatePartner.Customers collection and call the ById() method. Appelez ensuite la propriété DirectoryRoles , suivie de la méthode d' extraction () ou de la méthode GetAsync ().Then call the DirectoryRoles property, followed by the Get() or GetAsync() method.

// string selectedCustomerId;
// IAggregatePartner partnerOperations;

var directoryRoles = partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.Get();

Exemple: application de test console.Sample: Console test app. Projet: classed’exemples du kit de développement logiciel (SDK) Partner Center : GetCustomerDirectoryRoles.csProject: Partner Center SDK Samples Class: GetCustomerDirectoryRoles.cs

Pour récupérer une liste d’utilisateurs clients qui ont un rôle donné, récupérez d’abord l’ID de client et l’ID de rôle d’annuaire spécifiés.To retrieve a list of customer users that have a given role, first retrieve the specified customer ID and the directory role ID. Ensuite, utilisez votre collection collection iaggregatepartner. Customers et appelez la méthode méthode BYID () .Then, use your IAggregatePartner.Customers collection and call the ById() method. Appelez ensuite la propriété DirectoryRoles , puis la méthode méthode BYID () , puis la propriété UserMembers , la suivie par la méthode d' extraction () ou GetAsync () .Then call the DirectoryRoles property, then ById() method, then the UserMembers property, the followed by the Get() or GetAsync() method.

// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// string selectedDirectoryRoleId;

var userMembers = partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.ById(selectedDirectoryRoleId).UserMembers.Get();

Exemple: application de test console.Sample: Console test app. Projet: PartnerSDK. FeatureSamples, classe: GetCustomerDirectoryRoleUserMembers.csProject: PartnerSDK.FeatureSamples Class: GetCustomerDirectoryRoleUserMembers.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET {baseURL}/v1/Customers/{Customer-tenant-ID}/Users/{User-ID}/directoryroles http/1.1{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id}/directoryroles HTTP/1.1
GETGET {baseURL}/v1/Customers/{Customer-tenant-ID}/directoryroles http/1.1{baseURL}/v1/customers/{customer-tenant-id}/directoryroles HTTP/1.1
GETGET {baseURL}/v1/Customers/{Customer-tenant-ID}/directoryroles/{Role-ID}/usermembers{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers

Paramètre d’URIURI parameter

Utilisez le paramètre de requête suivant pour identifier le client approprié.Use the following query parameter to identify the correct customer.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-tenant-idcustomer-tenant-id guidguid OY La valeur est un GUID client-ID-client-ID qui permet au revendeur de filtrer les résultats pour un client donné qui appartient au revendeur.The value is a GUID formatted customer-tenant-id that allows the reseller to filter the results for a given customer that belongs to the reseller.
ID utilisateuruser-id guidguid NN La valeur est un ID utilisateur au format GUID qui appartient à un compte d’utilisateur unique.The value is a GUID formatted user-id that belongs to a single user account.
ID de rôlerole-id guidguid NN La valeur est un ID de rôle au format GUID qui appartient à un type de rôle.The value is a GUID formatted role-id that belongs to a type of role. Vous pouvez obtenir ces ID en interrogeant tous les rôles d’annuaire pour un client, sur tous les comptes d’utilisateur.You can get these IDs by querying all the directory roles for a customer, across all user accounts. (Deuxième scénario, ci-dessus).(The second scenario, above).

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Exemple de requêteRequest example

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users/<user-id>/directoryroles HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76

Réponse RESTREST response

En cas de réussite, cette méthode retourne une liste des rôles associés au compte d’utilisateur donné.If successful, this method returns a list of the roles associated with the given user account.

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 la liste complète, consultez Codes d’erreur.For the full list, see Error Codes.

Exemple de réponseResponse example

HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST

{
      "totalCount": 2,
      "items": [
        {
          "name": "Helpdesk Administrator",
          "id": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
          "attributes": { "objectType": "DirectoryRole" }
        },
        {
          "name": "User Account Administrator",
          "id": "fe930be7-5e62-47db-91af-98c3a49a38b1",
          "attributes": { "objectType": "DirectoryRole" }
        }
      ],
      "attributes": { "objectType": "Collection" }
}