Partager via

Obtenir une organisation cliente

S’applique à : Espace partenaires

Obtient une ressource d’organisation client.

Prérequis

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

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

Important

Les rôles GDAP sont requis pour appeler cette API. DAP n’est pas pris en charge.

Rôles GDAP

Vous aurez besoin d’au moins l’un des rôles GDAP suivants :

  • Créateur d’annuaire
  • Lecteur général

Demande REST

Syntaxe de la requête

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

Paramètre d’URI

Utilisez le paramètre de requête suivant pour un client spécifique.

Nom Type Obligatoire Description
customer-tenant-id guid Y La valeur est un identifiant client au format GUID, qui permet au revendeur de filtrer les résultats pour un client donné appartenant au revendeur.

En-têtes de la requête

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

Corps de la demande

Aucune.

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/organization HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

Réponse REST

Si elle réussit, cette méthode retourne une ressource Client 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: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

[
  {
    "street": "1 Microsoft Way",
    "countryLetterCode": "US",
    "postalCode": "98052-8300",
    "city": "Redmond",
    "state": "WA",
    "displayName": "Contoso",
    "technicalNotificationMails": [
      "test@contoso.com"
    ]
  }
]

Contenu connexe

  • Last updated on