Obtenir une organisation cliente
S’applique à : Espace partenaires
Obtient une ressource d’organisation client.
Prerequisites
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 par application uniquement.
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. L’authentification partenaire est toujours requise (AdminAgent/HelpDeskAgent/SalesAgent)
Rôles GDAP
Vous aurez besoin d’au moins l’un des rôles GDAP suivants :
- Administrateur général
- Enregistreur d’annuaire
- Lecteur général
Demande REST
Syntaxe de la requête
Method | URI de demande |
---|---|
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 |
---|---|---|---|
id-locataire-client | guid | O | La valeur est un ID client au format GUID qui permet au revendeur de filtrer les résultats d’un client donné qui appartient au revendeur. |
En-têtes de demande
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Corps de la demande
Aucun.
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: a176c585-b5de-4d65-824c-67a6deb45cd9
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: a176c585-b5de-4d65-824c-67a6deb45cd9
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"
]
}
]
Étapes suivantes
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour