Erstellen der Berechtigung für einen fileStorageContainerType

Namespace: microsoft.graph

Erstellen Sie ein Benutzerberechtigungsobjekt , das diese Berechtigung einem fileStorageContainerType hinzufügt. Nur vorhandene Besitzer (Benutzer mit der owner Rolle in der Berechtigungssammlung des Containertyps), SharePoint Embedded-Administratoren oder globale Administratoren können Berechtigungen hinzufügen.

Es gelten die folgenden Einschränkungen:

• Pro Containertyp sind maximal 3 Berechtigungen zulässig. Beim Hinzufügen einer vierten Berechtigung wird ein 400 Bad Request Fehler zurückgegeben.
• Doppelte Berechtigungen werden als idempotent behandelt. Wenn der angegebene Benutzer bereits über eine Berechtigung für den Containertyp verfügt, nimmt der Dienst keine Änderungen vor und gibt die vorhandene Berechtigungsressource im Antworttext mit einem 201 Created status zurück, obwohl keine neue Berechtigung erstellt wird.
• Derzeit wird nur die owner Rolle unterstützt.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

HTTP-Anforderung

POST /storage/fileStorage/containerTypes/{fileStorageContainerTypeId}/permissions

Anforderungsheader

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Berechtigungsobjekts an.

Sie können die folgenden Eigenschaften angeben, wenn Sie eine Berechtigung erstellen.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein Berechtigungsobjekt im Antworttext zurück.

Wenn die Anforderung den Grenzwert von drei Berechtigungen pro Containertyp überschreitet, gibt diese Methode einen 400 Bad Request Antwortcode zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Hinzufügen einer Besitzerberechtigung zu einem Containertyp.

POST https://graph.microsoft.com/beta/storage/fileStorage/containerTypes/de988700-d700-020e-0a00-0831f3042f00/permissions
Content-Type: application/json

{
  "roles": ["owner"],
  "grantedToV2": {
    "user": {
      "id": "11111111-1111-1111-1111-111111111111"
    }
  }
}

const options = {
	authProvider,
};

const client = Client.init(options);

const permission = {
  roles: ['owner'],
  grantedToV2: {
    user: {
      id: '11111111-1111-1111-1111-111111111111'
    }
  }
};

await client.api('/storage/fileStorage/containerTypes/de988700-d700-020e-0a00-0831f3042f00/permissions')
	.version('beta')
	.post(permission);

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.permission",
  "id": "b3duZXJfMTExMTExMTEtMTExMS0xMTExLTExMTEtMTExMTExMTExMTEx",
  "roles": ["owner"],
  "grantedToV2": {
    "user": {
      "id": "11111111-1111-1111-1111-111111111111"
    }
  }
}