Autorisations d’upsert

Espace de noms: microsoft.graph

Upsert (créer ou mettre à jour) jusqu’à 10 objets d’autorisation sur un fileStorageContainer dans une même requête. Le correctif delta permet à l’appelant d’effectuer plusieurs opérations (créer, mettre à jour) sur plusieurs autorisations avec une seule requête.

Cette API est disponible dans les déploiements de cloud national suivants.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Requête HTTP

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

En-têtes de demande

Corps de la demande

Dans le corps de la demande, fournissez un objet JSON avec les propriétés suivantes.

Chaque entrée de la collection de valeurs représente une opération sur une autorisation. La présence de la propriété id détermine la façon dont l’entrée est interprétée. Incluez l’ID d’une autorisation existante pour la mettre à jour, ou omettez l’ID pour créer une nouvelle autorisation.

Chaque entrée prend en charge les annotations et propriétés suivantes :

L’annotation @microsoft.graph.conflictBehavior est par élément. La valeur fail par défaut entraîne l’échec de l’élément avec un code de réponse par élément 409 Conflict . La valeur replace remplace le rôle existant pour l’identité par le rôle spécifié dans l’élément, et l’élément réussit. Toute autre valeur entraîne l’échec de l’élément avec un code de réponse par élément 400 Bad Request .

Les éléments de mise à jour ne doivent pas inclure de propriétés autres que l’ID et les rôles. La propriété roles est obligatoire. Les éléments qui enfreignent l’une ou l’autre règle échouent avec un code de réponse par élément 400 Bad Request .

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et une collection d’objets d’autorisation dans le corps de la réponse. Les autorisations traitées avec succès incluent un objet d’autorisation . Les éléments ayant échoué incluent une annotation @Core.DataModificationException avec les détails de l’erreur.

Cette API peut également retourner les codes de réponse d’erreur suivants pour l’ensemble de la requête :

Exemples

Demande

L’exemple suivant montre une seule demande de correctif delta qui combine des éléments de création et de mise à jour dans un seul appel. Les éléments sans ID sont traités comme des opérations de création ; les éléments avec un ID sont traités comme des opérations de mise à jour. Les éléments qui échouent sont signalés inline avec une annotation @Core.DataModificationException . Les autres éléments réussissent toujours.

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);

Réponse

L’exemple suivant illustre la réponse. Les deux premières opérations de création réussissent. La deuxième opération remplace le rôle existant pour l’utilisateur cible. La troisième opération de création échoue, car l’identité est déjà membre du conteneur avec un rôle différent. La première opération de mise à jour réussit. La deuxième opération de mise à jour échoue, car aucune autorisation avec cet ID n’existe.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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