domain: verify
Namespace: microsoft.graph
Überprüft den Besitz der Domäne.
Wichtig: Gilt nur für eine nicht überprüfte Domäne. Für eine nicht überprüfte Domäne ist die isVerified-Eigenschaft der Domäne false.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Domain.ReadWrite.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Domain.ReadWrite.All | Nicht verfügbar. |
Das Geschäfts-, Schul- oder Unikonto muss mindestens der Microsoft Entra-RolleDomänennamenadministrator angehören.
HTTP-Anforderung
POST /domains/{id}/verify
Geben Sie für {id} die Domäne mit ihrem vollqualifizierten Domänennamen an.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json |
Anforderungstext
Antwort
Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK
und das domain-Objekt im Antworttext zurückgegeben.
Beispiel
Anforderung
POST https://graph.microsoft.com/v1.0/domains/{domain-name}/verify
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"authenticationType": "authenticationType-value",
"availabilityStatus": "availabilityStatus-value",
"isAdminManaged": true,
"isDefault": true,
"isInitial": true,
"isRoot": true,
"id": "contoso.com"
}