Partager via

Obtenir le domaine personnalisé d’un client

  • Article

S’applique à : Espace partenaires

Obtient une ressource CustomDomain .

Lorsqu’un nouveau compte client est créé dans l’Espace partenaires, il reçoit un domaine unique. Ce domaine peut être utilisé pour identifier un client, et il peut également être utilisé à d’autres fins, telles que la configuration de boîte aux lettres.

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 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 avez besoin d’au moins l’un des rôles GDAP suivants :

  • Administrateur général
  • Enregistreur d’annuaire
  • Lecteur général
  • Administrateur de domaine

Demande REST

Syntaxe de la requête

Méthode URI de demande
GET {baseURL}/v1/customers/{customer-tenant-id}/customDomains HTTP/1.1

Paramètre d’URI

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

Nom Type Requise Description
id-locataire-client guid Y 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 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}/customDomains 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 de domaine personnalisée dans le corps de la réponse.

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

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et d’autres informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. 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

["contosco.onmicrosoft.com"]

Étapes suivantes