Récupérer la stratégie de configuration d’un client

  • Article

S’applique à : Espace partenaires

Comment récupérer la stratégie de configuration spécifiée pour le client spécifié.

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 des informations d’identification d’application et d’utilisateur autonomes.

  • ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace partenaires en sélectionnant l’espace de travail Clients , puis le client dans la liste des clients, puis Compte. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).

  • Identificateur de stratégie.

C#

Pour récupérer une stratégie de configuration pour le client spécifié, appelez d’abord la méthode IAggregatePartner.Customers.ById avec l’ID client afin de récupérer une interface aux opérations sur le client spécifié. Ensuite, appelez la méthode ConfigurationPolicies.ById avec l’ID de stratégie pour récupérer une interface aux opérations de stratégie de configuration pour la stratégie spécifiée. Enfin, appelez la méthode Get ou GetAsync pour récupérer la stratégie de configuration.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;

ConfigurationPolicy retrievedConfigurationPolicy =
    partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedConfigurationPolicyId).Get();

Exemple : Application de test console. Projet : Classe d’exemples sdk de l’Espace partenaires : GetConfigurationPolicy.cs

Demande REST

Syntaxe de la requête

Méthode URI de requête
GET {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

Paramètre d’URI

Utilisez les paramètres de chemin d’accès et de requête suivants lors de la création de la demande.

Nom Type Obligatoire Description
customer-id string Oui Chaîne au format GUID qui identifie le client.
policy-id string Oui Chaîne au format GUID qui identifie la stratégie.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

None

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Content-Length: 0
Host: api.partnercenter.microsoft.com

Réponse REST

Si elle réussit, la réponse contient la ressource ConfigurationPolicy demandée.

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 REST de l’Espace partenaires.

Exemple de réponse

HTTP/1.1 200 OK
Content-Length: 443
MS-CorrelationId: abe150cf-c677-435c-b5d5-b34899a6d1ec
MS-RequestId: ab3abfe7-dce7-46c0-ab20-4fd49bc3e2f7
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:08:27 GMT

{
    "id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
    "name": "Test policy",
    "category": "o_o_b_e",
    "description": "Test policy creation from API 1",
    "devicesAssigned": 0,
    "policySettings": ["skip_express_settings"],
    "createdDate": "2017-07-25T11:03:03.8457116-07:00",
    "lastModifiedDate": "2017-07-25T11:04:00.8149974-07:00",
    "attributes": {
        "objectType": "ConfigurationPolicy"
    }
}