Crear permiso en un elemento de unidad

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Crear un nuevo objeto de permiso en un elemento de unidad.

Importante

Esta API tiene las siguientes restricciones:

  • Para OneDrive profesional o educativo y SharePoint Online, solo puede usar este método para crear un nuevo permiso de aplicación. Si quieres crear un nuevo permiso de usuario en un elemento de unidad, consulta invitar. Para obtener más información sobre los permisos de aplicación, vea Información general sobre los permisos seleccionados en OneDrive y SharePoint.
  • Para SharePoint Embedded, solo puede usar este método para crear un nuevo permiso de sharePointGroup con acceso solo de aplicación. No se puede crear un permiso en el elemento raíz de un contenedor.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Files.ReadWrite Files. ReadWrite.All, Files. SelectedOperations.Selected, Sites.ReadWrite.All, Sites.FullControl.All, Sites.Manage.All, Sites.Selected, Lists.SelectedOperations.Selected, ListItems.SelectedOperations.Selected
Delegado (cuenta personal de Microsoft) Files.ReadWrite Files.ReadWrite.All
Aplicación Files.ReadWrite.All Sites.FullControl.All, Sites.Manage.All, Sites.ReadWrite.All, Sites.Selected, Files. SelectedOperations.Selected, Lists.SelectedOperations.Selected, ListItems.SelectedOperations.Selected

Nota:

SharePoint Embedded requiere permiso FileStorageContainer.Selected para acceder al contenido del contenedor. Este permiso es diferente de los mencionados anteriormente. Además de los permisos de Microsoft Graph, la aplicación debe tener los permisos de tipo de contenedor necesarios para llamar a esta API. Para obtener más información, consulte Autenticación y autorización de SharePoint Embedded.

Solicitud HTTP

POST /drives/{drive-id}/items/{item-id}/permissions
POST /groups/{group-id}/drive/items/{item-id}/permissions
POST /me/drive/items/{item-id}/permissions
POST /sites/{siteId}/drive/items/{itemId}/permissions
POST /users/{userId}/drive/items/{itemId}/permissions

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto de permiso .

Importante

  • Esta API solo acepta grantedToV2 como entrada para el objeto de permiso . No se aceptan otras propiedades, como grantedToIdentitiesV2 o las obsoletas grantedTo y grantedToIdentities .
  • En el caso de SharePoint Embedded, al crear un nuevo permiso de sharePointGroup , se recomienda hacer referencia al sharePointGroup mediante la propiedad grantedToV2.sharePointGroup.id del cuerpo de la solicitud. Este identificador debe asignarse al identificador de la propiedad sharePointGroup . Para obtener más información, vea el ejemplo 2. No se recomienda hacer referencia a un sharePointGroup con su principalId porque este es único dentro del sitio, a diferencia del identificador de sharePointGroup, que es único a nivel mundial. En ese caso, el cuerpo de la solicitud debe incluir tanto id como displayName en la propiedad grantedToV2.siteGroup . El identificador debe apuntar al elemento principalId del sharePointGroup y la opción displayName debe apuntar al título del elemento sharePointGroup. Para obtener más información, vea el ejemplo 3.

Respuesta

Si se realiza correctamente, este método devuelve un código de 201 Created respuesta y un objeto de permiso en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Agregar un permiso de aplicación a un elemento de unidad en OneDrive o SharePoint Online

En el ejemplo siguiente se muestra cómo agregar un writepermiso para la aplicación identificada por 89ea5c94-7736-4e25-95ad-3fa95f62b66e, en un elemento deContoso Time Manager App unidad identificado por 01V4EPHZNV2OJQJNBPWNCKDTXCQ5TSVBJU en una unidad identificada por b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/drives/b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop/items/01V4EPHZNV2OJQJNBPWNCKDTXCQ5TSVBJU/permissions
Content-Type: application/json

{
  "grantedToV2": {
    "application": {
      "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e"
    }
  },
  "roles": ["write"]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

{
  "id": "aTowaS50fG1zLnNwLmV4dHw4OWVhNWM5NC03NzM2LTRlMjUtOTVhZC0zZmE5NWY2MmI2NmVAZDljZTBmYzEtNjFkOC00YTJlLWI1ZDMtMTg3NzBkZjA2NzJj",
  "roles": [
    "write"
  ],
  "grantedTo": {
    "application": {
      "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",
      "displayName": "Contoso Time Manager App"
    }
  },
  "grantedToV2": {
    "application": {
      "id": "89ea5c94-7736-4e25-95ad-3fa95f62b66e",
      "displayName": "Contoso Time Manager App"
    }
  }
}

Ejemplo 2: Agregar un permiso de grupo de SharePoint a un elemento de unidad en un contenedor de SharePoint Embedded usando su identificador

En el ejemplo siguiente se muestra cómo agregar un writepermiso para sharePointGroupinternal collaborators en un elemento driveItem identificado por 01V4EPHZNV2OJQJNBPWNCKDTXCQ5TSVBJU en un fileStorageContainer de SharePoint Embedded identificado por b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/drives/b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop/items/01V4EPHZNV2OJQJNBPWNCKDTXCQ5TSVBJU/permissions
Content-Type: application/json

{
  "grantedToV2": {
    "sharePointGroup": {
      "id": "ZGYwZTEzYTgtOTExOS00MjdmLWEzNjktOTdjOWM3YjNlYjcyXzE0"
    }
  },
  "roles": ["write"]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

{
  "id": "aTowaS50fG1zLnNwLmV4dHwxMEBkOWNlMGZjMS02MWQ4LTRhMmUtYjVkMy0xODc3MGRmMDY3MmM=",
  "roles": [
    "write"
  ],
  "grantedToV2": {
    "sharePointGroup": {
      "id": "ZGYwZTEzYTgtOTExOS00MjdmLWEzNjktOTdjOWM3YjNlYjcyXzE0",
      "principalId": "10",
      "title": "Internal Collaborators"
    },
    "siteGroup": {
      "id": "10",
      "displayName": "Internal Collaborators"
    }
  },
  "grantedTo": {
    "siteGroup": {
      "id": "10",
      "displayName": "Internal Collaborators"
    }
  }
}

Ejemplo 3: Agregar un permiso de grupo de SharePoint a un elemento de unidad en un contenedor de SharePoint Embedded mediante el valor principalId

En el ejemplo siguiente se muestra cómo agregar un writepermiso para sharePointGroupinternal collaborators en un elemento driveItem identificado por 01V4EPHZNV2OJQJNBPWNCKDTXCQ5TSVBJU en un fileStorageContainer de SharePoint Embedded identificado por b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/drives/b!s8RqPCGh0ESQS2EYnKM0IKS3lM7GxjdAviiob7oc5pXv_0LiL-62Qq3IXyrXnEop/items/01V4EPHZNV2OJQJNBPWNCKDTXCQ5TSVBJU/permissions
Content-Type: application/json

{
  "grantedToV2": {
    "siteGroup": {
      "id": "10",
      "displayName": "Internal Collaborators"
    }
  },
  "roles": ["write"]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

{
  "id": "aTowaS50fG1zLnNwLmV4dHwxMEBkOWNlMGZjMS02MWQ4LTRhMmUtYjVkMy0xODc3MGRmMDY3MmM=",
  "roles": [
    "write"
  ],
  "grantedToV2": {
    "siteGroup": {
      "id": "10",
      "displayName": "Internal Collaborators"
    }
  },
  "grantedTo": {
    "siteGroup": {
      "id": "10",
      "displayName": "Internal Collaborators"
    }
  }
}