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
Cree un nuevo objeto accessPackage .
El paquete de acceso se agregará a un accessPackageCatalog existente.
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 | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | EntitlementManagement.ReadWrite.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | EntitlementManagement.ReadWrite.All | No disponible. |
Sugerencia
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión también se le debe asignar un rol de administrador con permisos de rol admitidos mediante una de las siguientes opciones:
-
Un rol en el sistema de administración de derechos donde los roles con privilegios mínimos son:
- Acceso al administrador de paquetes. Esta es la opción con menos privilegios
- Propietario del catálogo
- Roles de Microsoft Entra con más privilegios admitidos para esta operación:
- Administrador de gobernanza de identidades
En escenarios de solo aplicación, se puede asignar a la aplicación que realiza la llamada uno de los roles admitidos anteriores en lugar del permiso de EntitlementManagement.ReadWrite.All aplicación. El rol administrador de paquetes de Access tiene menos privilegios que el permiso de aplicación EntitlementManagement.ReadWrite.All .
Para obtener más información, vea Delegación y roles en la administración de derechos y cómo delegar la gobernanza del acceso a administradores de paquetes de acceso en la administración de derechos.
Solicitud HTTP
POST /identityGovernance/entitlementManagement/accessPackages
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Tipo de contenido | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON del objeto accessPackage .
Puede especificar las siguientes propiedades al crear un accessPackage.
| Propiedad | Tipo | Descripción |
|---|---|---|
| catálogo | accessPackageCatalog | Obligatorio. Catálogo vinculado a este paquete de acceso. Solo se requiere la propiedad id . |
| displayName | Cadena | Obligatorio. Nombre para mostrar del paquete de acceso. |
| description | Cadena | Opcional. Descripción del paquete de acceso. |
| isHidden | Booleano | Opcional. Si el paquete de acceso está oculto al solicitante. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un nuevo objeto accessPackage en el cuerpo de la respuesta.
Ejemplos
Solicitud
POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackages
Content-Type: application/json
{
"displayName": "sales reps",
"description": "outside sales representatives",
"isHidden": false,
"catalog": {
"id": "66584aae-98bb-48cc-9458-7bee5d2a6577"
}
}
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
{
"id": "642181f0-bc17-4fc6-9ebb-ff53dbf18c2f",
"displayName": "sales reps",
"description": "outside sales representatives",
"isHidden": false,
"createdDateTime": "2021-11-10T01:10:09.5220119Z",
"modifiedDateTime": "2021-11-10T01:10:09.5220119Z"
}