Condividi tramite

Ottenere il dominio personalizzato di un cliente

  • Articolo

Si applica a: Centro per i partner

Ottiene una risorsa CustomDomain .

Quando viene creato un nuovo account cliente nel Centro per i partner, viene assegnato un dominio univoco. Questo dominio può essere usato per identificare un cliente e può essere usato anche per altri scopi, ad esempio la configurazione della cassetta postale.

Prerequisiti

  • Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta le credenziali app+utente o l'autenticazione solo app.

  • ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner. Selezionare l'area di lavoro Clienti nella home page del Centro per i partner. Selezionare il cliente dall'elenco Clienti, quindi selezionare Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Dettagli account cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

Importante

I ruoli GDAP sono necessari per chiamare questa API. DAP non è supportato. L'autenticazione partner è ancora necessaria (AdminAgent/HelpDeskAgent/SalesAgent)

Ruoli GDAP

Sono necessari almeno uno dei ruoli GDAP seguenti:

  • Amministratore globale
  • Ruolo con autorizzazioni di scrittura nella directory
  • Ruolo con autorizzazioni di lettura globali
  • Amministratore di dominio

Richiesta REST

Sintassi della richiesta

metodo URI della richiesta
GET {baseURL}/v1/customers/{customer-tenant-id}/customDomains HTTP/1.1

Parametro URI

Usare il parametro di query seguente per un cliente specifico.

Nome Digita Obbligatorio Descrizione
customer-tenant-id guid Y Il valore è un GUID formattato customer-tenant-id che consente al rivenditore di filtrare i risultati per un determinato cliente appartenente al rivenditore.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce una risorsa di dominio personalizzata nel corpo della risposta.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

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"]

Contenuto correlato