Enumerar driveProtectionUnits
Espacio de nombres: microsoft.graph
Obtenga una lista de los objetos driveProtectionUnit asociados a oneDriveForBusinessProtectionPolicy.
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) | BackupRestore-Configuration.Read.All | No disponible. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | BackupRestore-Configuration.Read.All | No disponible. |
Solicitud HTTP
GET /solutions/backupRestore/protectionUnits/microsoft.graph.driveProtectionUnit
GET /solutions/backupRestore/oneDriveForBusinessProtectionPolicies/{oneDriveForBusinessProtectionPolicyId}/driveProtectionUnits
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y una colección de driveProtectionUnit en el cuerpo de la respuesta.
Para obtener una lista de posibles respuestas de error, consulte Backup Storage API error responses (Respuestas de error de la API de Backup Storage).
Ejemplos
Ejemplo 1: Enumerar todas las driveProtectionUnits de un inquilino
En el ejemplo siguiente se muestra cómo obtener una lista de todos los objetos driveProtectionUnits de un inquilino.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET /solutions/backupRestore/protectionUnits/microsoft.graph.driveProtectionUnit
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
{
"@odata.nextLink": "https://graph.microsoft.com/v1.0/solutions/backupRestore/protectionUnits/microsoft.graph.driveProtectionUnit?$skiptoken=M2UyZDAwMDAwMDMxMzkzYTMyNjQ2MTM0NjMzMjM5NjYzNjY0MzczMDM0MzE2NTYzNjEzNzMwNjIzNjMzMzg2MjM0MzM2NDM0MzUzNDMzMzc0MDc0Njg3MjY1NjE2NDJlNzYzMjAxZThmYjY4M2Y3ODAxMDAwMDg4NjA5ODdhNzgwMTAwMDB8MTYxNjk2NDUwOTgzMg%3d%3d",
"value": [
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "2b014d8c-71fe-4d00-a01a-31850bc5b32c",
"directoryObjectId": "384974e2-72cd-48de-a6e8-6985d7c5db90",
"displayName": "Emily Braun", // Newly Added
"email": "emilyb@contoso.com", // Newly Added
"status": "unprotected",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
},
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "8f014d8c-71fe-4d00-a01a-31850bc5b32c",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"directoryObjectId": "781d9337-d8f0-456e-92cd-00a3abdd2093",
"displayName": "Alex Wilber", // Newly Added
"email": "alexw@contoso.com", // Newly Added
"status": "protectRequested",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
},
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "9b014d8c-71fe-4d00-a01a-31850bc5b32c",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"directoryObjectId": "2d1d9337-d8f0-456e-92cd-00a3abdd2093",
"displayName": "Shaun Wong", // Newly Added
"email": "shaunw@contoso.com", // Newly Added
"status": "unprotected",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
},
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "9b014d8c-71fe-4d00-a01a-31850bc5b32c",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"directoryObjectId": "2e1d9337-d8f0-456e-92cd-00a3abdd2093",
"displayName": "Janet Green", // Newly Added
"email": "janetg@contoso.com", // Newly Added
"status": "protected",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
},
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "9b014d8c-71fe-4d00-a01a-31850bc5b32c",
"directoryObjectId": "2w1d9337-d8f0-456e-92cd-00a3abdd2093",
"displayName": "Eddie Brock ", // Newly Added
"email": "eddyb@contoso.com", // Newly Added
"status": "unprotected",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
}
]
}
Ejemplo 2: Enumerar las driveProtectionUnits asociadas a una directiva de protección profesional o educativa de OneDrive
En el ejemplo siguiente se muestra cómo enumerar todas las driveProtectionUnits asociadas a oneDriveForBusinessProtectionPolicy.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET /solutions/backupRestore/oneDriveForBusinessProtectionPolicies/845457dc-4bb2-4815-bef3-8628ebd1952e/driveProtectionUnits
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
{
"@odata.nextLink": "https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/845457dc-4bb2-4815-bef3-8628ebd1952e/driveProtectionUnits?$skiptoken=M2UyZDAwMDAwMDMxMzkzYTMyNjQ2MTM0NjMzMjM5NjYzNjY0MzczMDM0MzE2NTYzNjEzNzMwNjIzNjMzMzg2MjM0MzM2NDM0MzUzNDMzMzc0MDc0Njg3MjY1NjE2NDJlNzYzMjAxZThmYjY4M2Y3ODAxMDAwMDg4NjA5ODdhNzgwMTAwMDB8MTYxNjk2NDUwOTgzMg%3d%3d",
"value": [
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "2b014d8c-71fe-4d00-a01a-31850bc5b32c",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"directoryObjectId": "384974e2-72cd-48de-a6e8-6985d7c5db90",
"displayName": "Emily Braun", // Newly Added
"email": "emilyb@contoso.com", // Newly Added
"status": "protectRequested",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
},
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "57014d8c-71fe-4d00-a01a-31850bc5b32c",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"directoryObjectId": "184d9337-d8f0-456e-92cd-00a3abdd2093",
"displayName": "Alex Wilber", // Newly Added
"email": "alexw@contoso.com", // Newly Added
"status": "protectRequested",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
},
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "17014d8c-71fe-4d00-a01a-31850bc5b32c",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"directoryObjectId": "344d9337-d8f0-456e-92cd-00a3abdd2093",
"displayName": "Shaun Wong", // Newly Added
"email": "shaunw@contoso.com", // Newly Added
"status": "protectRequested",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
},
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "8f014d8c-71fe-4d00-a01a-31850bc5b32c",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"directoryObjectId": "781d9337-d8f0-456e-92cd-00a3abdd2093",
"displayName": "Janet Green", // Newly Added
"email": "janetg@contoso.com", // Newly Added
"status": "protectRequested",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
},
{
"@odata.type": "#microsoft.graph.driveProtectionUnit",
"id": "9b014d8c-71fe-4d00-a01a-31850bc5b32c",
"policyId": "9fec8e78-bce4-4aaf-ab1b-5451cc387264",
"directoryObjectId": "2d1d9337-d8f0-456e-92cd-00a3abdd2093",
"displayName": "Eddie Brock ", // Newly Added
"email": "eddyb@contoso.com", // Newly Added
"status": "protectRequested",
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2015-06-19T12:01:03.45Z",
"lastModifiedBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"email": "User1@contoso.com",
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
"error": null
}
]
}