Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 Requesterror. - 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 Createdestado, aunque no se cree ningún nuevo permiso. - Actualmente solo se admite el
ownerrol.
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"
}
}
}