group: validateProperties

  • Artikel

Namespace: microsoft.graph

Überprüfen Sie, ob der Anzeigename oder E-Mail-Spitzname einer Microsoft 365-Gruppe den Benennungsrichtlinien entspricht. Clients können die API verwenden, um zu bestimmen, ob ein Anzeigename oder E-Mail-Spitzname gültig ist, bevor sie versuchen, eine Microsoft 365-Gruppe zu aktualisieren . Verwenden Sie zum Überprüfen von Eigenschaften vor dem Erstellen einer Gruppe die validateProperties-Funktion für Verzeichnisobjekte.

Die folgenden Überprüfungen werden für die Eigenschaften Anzeigename und E-Mail-Spitzname durchgeführt:

  1. Überprüfen der Präfix- und Suffixbenennungsrichtlinie
  2. Überprüfen der Richtlinie für benutzerdefinierte gesperrte Wörter

Diese API gibt mit dem ersten aufgetretenen Fehler zurück. Wenn eine oder mehrere Eigenschaften mehrere Überprüfungen nicht bestehen, wird nur die Eigenschaft mit dem ersten Überprüfungsfehler zurückgegeben. Sie können jedoch sowohl den E-Mail-Spitznamen als auch den Anzeigenamen überprüfen und eine Sammlung von Validierungsfehlern erhalten, wenn Sie nur die Präfix- und Suffixbenennungsrichtlinie überprüfen.

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) Group.Read.All Group.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Group.Read.All Group.ReadWrite.All

HTTP-Anforderung

POST /groups/{id}/validateProperties

Anforderungsheader

Name Beschreibung
Authorization Bearer {code}
Content-Type application/json

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter Typ Beschreibung
displayName String Der Anzeigename der zu überprüfenden Gruppe. Die -Eigenschaft ist nicht einzeln erforderlich. Es ist jedoch mindestens eine Eigenschaft (displayName oder mailNickname) erforderlich.
mailNickname String Der E-Mail-Spitzname der zu überprüfenden Gruppe. Die -Eigenschaft ist nicht einzeln erforderlich. Es ist jedoch mindestens eine Eigenschaft (displayName oder mailNickname) erforderlich.
onBehalfOfUserId GUID Die Objekt-ID des Benutzers, der beim Aufrufen der API die Identität annehmen soll. Die Validierungsergebnisse gelten für die Attribute und Rollen von onBehalfOfUserId.

Antwort

Wenn die Methode erfolgreich verläuft und keine Validierungsfehler auftreten, gibt die Methode den Antwortcode zurück 204 No Content . Es gibt nichts im Antworttext zurück.

Wenn die Anforderung ungültig ist, gibt die Methode den Antwortcode zurück 400 Bad Request . Eine Fehlermeldung mit Details zur ungültigen Anforderung wird im Antworttext zurückgegeben.

Wenn ein Überprüfungsfehler vorliegt. Die Methode gibt den Antwortcode zurück 422 Unprocessable Entity . Eine Fehlermeldung und eine Auflistung von Fehlerdetails werden im Antworttext zurückgegeben.

Beispiele

Dies ist ein Beispiel für eine erfolgreiche Überprüfungsanforderung.

Anforderung

POST https://graph.microsoft.com/beta/groups/{id}/validateProperties
Content-type: application/json

{
  "displayName": "Myprefix_test_mysuffix",
  "mailNickname": "Myprefix_test_mysuffix",
  "onBehalfOfUserId": "onBehalfOfUserId-value"
}

Antwort

HTTP/1.1 204 No Content

Dies ist ein Beispiel für eine Anforderung mit Validierungsfehlern.

Anforderung

POST https://graph.microsoft.com/beta/groups/{id}/validateProperties
Content-type: application/json

{
  "displayName": "MyPrefix_test_mysuffix",
  "mailNickname": "MyPrefix_test_mysuffix"
}

Antwort

HTTP/1.1 422
Content-type: application/json

{
  "error": {
    "code": "Request_UnprocessableEntity",
    "message": "The values provided contain one or more validation errors.",
    "innerError": {
      "request-id": "id-value",
      "date": "date-value"
    },
    "details": [
      {
        "target": "mailNickname",
        "code": "PropertyConflict",
        "message": "Another object with the same value for property mailNickname already exists."
      }
    ]
  }
}