Permissões de upsert

Namespace: microsoft.graph

Upsert (criar ou atualizar) até 10 objetos de permissão num ficheiroStorageContainer num único pedido. O patch Delta permite que o autor da chamada execute várias operações (criar, atualizar) em várias permissões com um único pedido.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Solicitação HTTP

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

Cabeçalhos de solicitação

Corpo da solicitação

No corpo do pedido, forneça um objeto JSON com as seguintes propriedades.

Cada entrada na coleção de valores representa uma operação numa permissão. A presença da propriedade ID determina a forma como a entrada é interpretada. Inclua o ID de uma permissão existente para atualizá-la ou omita o ID para criar uma nova permissão.

Cada entrada suporta as seguintes propriedades e anotações:

A anotação @microsoft.graph.conflictBehavior é por item. O valor fail predefinido faz com que o item falhe com um código de resposta por item 409 Conflict . O valor replace substitui a função existente para a identidade pela função especificada no item e o item é bem-sucedido. Qualquer outro valor faz com que o item falhe com um código de resposta por item 400 Bad Request .

Os itens de atualização não podem incluir propriedades que não o ID e as funções. A propriedade de funções é necessária. Os itens que violam qualquer uma das regras falham com um código de resposta por item 400 Bad Request .

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e uma coleção de objetos de permissão no corpo da resposta. As permissões que são processadas com êxito incluem um objeto de permissão . Os itens com falha incluem uma anotação @Core.DataModificationException com detalhes de erro.

Esta API também pode devolver os seguintes códigos de resposta de erro para todo o pedido:

Exemplos

Solicitação

O exemplo seguinte mostra um único pedido de patch delta que combina criar e atualizar itens numa chamada. Os itens sem um ID são tratados como operações de criação; os itens com um ID são tratados como operações de atualização. Os itens que falham são comunicados inline com uma anotação @Core.DataModificationException . Os restantes itens continuam a ser bem-sucedidos.

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

Resposta

O exemplo a seguir mostra a resposta. As duas primeiras operações de criação são bem-sucedidas. A segunda operação substitui a função existente para o utilizador de destino. A terceira operação de criação falha porque a identidade já é um membro do contentor com uma função diferente. A primeira operação de atualização é concluída com êxito. A segunda operação de atualização falha porque não existe permissão com esse ID.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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