Compartir a través de


Crear permiso para un archivoStorageContainerType

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.

Cree un objeto de permiso de usuario, que agrega este permiso a un fileStorageContainerType. Solo los propietarios existentes (los usuarios con el owner rol en la colección de permisos del tipo de contenedor), los administradores incrustados de SharePoint o los administradores globales pueden agregar permisos.

Se aplican las siguientes restricciones:

  • Se permite un máximo de 3 permisos por tipo de contenedor. Al agregar un cuarto permiso, se devuelve un 400 Bad Request error.
  • Los permisos duplicados se tratan como idempotentes. Si el usuario especificado ya tiene un permiso en el tipo de contenedor, el servicio no realiza cambios y devuelve el recurso de permiso existente en el cuerpo de la respuesta con un 201 Created estado, aunque no se cree ningún nuevo permiso.
  • Actualmente solo se admite el owner rol.

Nota:

  • Los usuarios invitados no pueden ser destinatarios de permisos de tipo contenedor.
  • Los usuarios invitados no pueden realizar esta operación.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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 Permiso con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) FileStorageContainerType.Manage.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la 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 .

Puede especificar las siguientes propiedades al crear un permiso.

Propiedad Tipo Description
grantedToV2 sharePointIdentitySet Identidad del usuario al que se va a conceder el permiso. Solo se admite la propiedad user con el identificador del usuario; no se admiten las identidades de grupo ni de aplicación. Obligatorio.
roles Colección de cadenas Roles concedidos al usuario. Actualmente solo owner se admite. Obligatorio.

Respuesta

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

Si la solicitud supera el límite de tres permisos por tipo de contenedor, este método devuelve un 400 Bad Request código de respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra una solicitud para agregar un permiso de propietario a un tipo de contenedor.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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