Berechtigungen für Upsert verwenden

Namespace: microsoft.graph

Upsert (erstellen oder aktualisieren) von bis zu 40 Berechtigungsobjekten auf einem fileStorageContainer in einer einzigen Anforderung. Mit dem Deltapatch kann der Aufrufer mit einer einzigen Anforderung mehrere Vorgänge (erstellen, aktualisieren) für mehrere Berechtigungen ausführen.

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

PATCH /storage/fileStorage/containers/{containerId}/permissions

Anforderungsheader

Anforderungstext

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

Jeder Eintrag in der Wertauflistung stellt einen Vorgang für eine Berechtigung dar. Das Vorhandensein der id-Eigenschaft bestimmt, wie der Eintrag interpretiert wird. Schließen Sie die ID einer vorhandenen Berechtigung ein, um sie zu aktualisieren, oder lassen Sie die ID weg, um eine neue Berechtigung zu erstellen.

Jeder Eintrag unterstützt die folgenden Eigenschaften und Anmerkungen:

Die @microsoft.graph.conflictBehavior-Anmerkung wird pro Element angewendet. Der Standardwert fail bewirkt, dass das Element mit einem Antwortcode pro Element 409 Conflict fehlschlägt. Der Wert replace ersetzt die bestehende Rolle für die Identität durch die im Element angegebene Rolle, und das Element ist erfolgreich. Jeder andere Wert führt dazu, dass das Element mit einem Antwortcode pro Element 400 Bad Request fehlschlägt.

Updateelemente dürfen keine anderen Eigenschaften als ID und Rollen enthalten. Die roles-Eigenschaft ist erforderlich. Elemente, die gegen eine der beiden Regeln verstoßen, schlagen mit einem Antwortcode pro Element 400 Bad Request fehl.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und eine Auflistung von Berechtigungsobjekten im Antworttext zurück. Berechtigungen, die erfolgreich verarbeitet werden, enthalten ein Berechtigungsobjekt . Fehlerhafte Elemente enthalten eine @Core.DataModificationException-Anmerkung mit Fehlerdetails.

Diese API gibt möglicherweise auch die folgenden Fehlerantwortcodes für die gesamte Anforderung zurück:

Beispiele

Anforderung

Das folgende Beispiel zeigt eine einzelne Delta-Patchanforderung, die Elemente in einem Aufruf kombiniert, erstellt und aktualisiert. Elemente ohne ID werden als Erstellungsvorgänge behandelt. Elemente mit einer ID werden als Aktualisierungsvorgänge behandelt. Elemente, die fehlschlagen, werden inline mit einer @Core.DataModificationException-Anmerkung gemeldet. Die restlichen Elemente sind weiterhin erfolgreich.

PATCH https://graph.microsoft.com/beta/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/permissions
Content-Type: application/json

{
  "@context": "#$delta",
  "value": [
    {
      "roles": ["reader"],
      "grantedToV2": {
        "user": {
          "userPrincipalName": "alex@contoso.com"
        }
      }
    },
    {
      "@microsoft.graph.conflictBehavior": "replace",
      "roles": ["writer"],
      "grantedToV2": {
        "user": {
          "userPrincipalName": "kate@contoso.com"
        }
      }
    },
    {
      "roles": ["owner"],
      "grantedToV2": {
        "user": {
          "userPrincipalName": "mike@contoso.com"
        }
      }
    },
    {
      "id": "X2k6MCMuZnxtZW1iZXJzaGlwfGFsZXhAY29udG9zby5jb20",
      "roles": ["manager"]
    },
    {
      "id": "X2k6MCMuZnxtZW1iZXJzaGlwfG5vdGFmb3VuZEBjb250b3NvLmNvbQ",
      "roles": ["manager"]
    }
  ]
}

const options = {
	authProvider,
};

const client = Client.init(options);

const permissions = {
  '@context': '#$delta',
  value: [
    {
      roles: ['reader'],
      grantedToV2: {
        user: {
          userPrincipalName: 'alex@contoso.com'
        }
      }
    },
    {
      '@microsoft.graph.conflictBehavior': 'replace',
      roles: ['writer'],
      grantedToV2: {
        user: {
          userPrincipalName: 'kate@contoso.com'
        }
      }
    },
    {
      roles: ['owner'],
      grantedToV2: {
        user: {
          userPrincipalName: 'mike@contoso.com'
        }
      }
    },
    {
      id: 'X2k6MCMuZnxtZW1iZXJzaGlwfGFsZXhAY29udG9zby5jb20',
      roles: ['manager']
    },
    {
      id: 'X2k6MCMuZnxtZW1iZXJzaGlwfG5vdGFmb3VuZEBjb250b3NvLmNvbQ',
      roles: ['manager']
    }
  ]
};

await client.api('/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/permissions')
	.version('beta')
	.update(permissions);

Antwort

Das folgende Beispiel zeigt die Antwort. Die ersten beiden Erstellungsvorgänge sind erfolgreich. Der zweite Vorgang ersetzt die vorhandene Rolle für den Zielbenutzer. Der dritte Erstellungsvorgang schlägt fehl, da die Identität bereits ein Mitglied des Containers mit einer anderen Rolle ist. Der erste Updatevorgang ist erfolgreich. Der zweite Updatevorgang schlägt fehl, da keine Berechtigung mit dieser ID vorhanden ist.

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#storage/fileStorage/containers('b%21ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z')/permissions/$delta",
  "value": [
    {
      "id": "X2k6MCMuZnxtZW1iZXJzaGlwfGFsZXhAY29udG9zby5jb20",
      "roles": [
        "reader"
      ],
      "grantedToV2": {
        "user": {
          "displayName": "Alex Wilson",
          "id": "1a2b3c4d-1111-2222-3333-444455556666",
          "userPrincipalName": "alex@contoso.com"
        }
      }
    },
    {
      "id": "X2k6MCMuZnxtZW1iZXJzaGlwfGthdGVAY29udG9zby5jb20",
      "roles": [
        "writer"
      ],
      "grantedToV2": {
        "user": {
          "displayName": "Kate Brown",
          "id": "2b3c4d5e-2222-3333-4444-555566667777",
          "userPrincipalName": "kate@contoso.com"
        }
      }
    },
    {
      "@Core.DataModificationException": {
        "@odata.type": "#Org.OData.Core.V1.DataModificationExceptionType",
        "failedOperation": "Create",
        "responseCode": 409,
        "info": {
          "code": "Conflict",
          "message": "Conflict: this identity is a [Reader] member of the container and cannot be added to the [Owner] role."
        }
      },
      "id": "00000000-0000-0000-0000-000000000000",
      "roles": [
        "owner"
      ],
      "grantedToV2": {
        "user": {
          "userPrincipalName": "mike@contoso.com"
        }
      }
    },
    {
      "id": "X2k6MCMuZnxtZW1iZXJzaGlwfGFsZXhAY29udG9zby5jb20",
      "roles": [
        "manager"
      ],
      "grantedToV2": {
        "user": {
          "displayName": "Alex Wilson",
          "id": "1a2b3c4d-1111-2222-3333-444455556666",
          "userPrincipalName": "alex@contoso.com"
        }
      }
    },
    {
      "@Core.DataModificationException": {
        "@odata.type": "#Org.OData.Core.V1.DataModificationExceptionType",
        "failedOperation": "Update",
        "responseCode": 404,
        "info": {
          "code": "NotFound",
          "message": "Item not found."
        }
      },
      "id": "X2k6MCMuZnxtZW1iZXJzaGlwfG5vdGFmb3VuZEBjb250b3NvLmNvbQ"
    }
  ]
}