Enumeración de retentionLabels

  • Artículo

Espacio de nombres: microsoft.graph.security

Importante

Las API de la /beta versión 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 versiones .

Obtenga una lista de los objetos retentionLabel y sus propiedades.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) RecordsManagement.Read.All, RecordsManagement.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitido.
Aplicación No admitida.

Solicitud HTTP

GET /security/labels/retentionLabels

Parámetros de consulta opcionales

Este método admite la expansión de parámetros de consulta de OData para ayudar a personalizar la respuesta. Por ejemplo, para recuperar la propiedad retentionEventType , puede usar el expand parámetro:$expand=retentionEventType. Para obtener información general, vea Parámetros de consulta OData.

Encabezados de solicitud

Nombre Descripción
Authorization Portador {token}. Obligatorio.

Cuerpo de 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 objetos microsoft.graph.security.retentionLabel en el cuerpo de la respuesta.

Ejemplos

Solicitud

GET https://graph.microsoft.com/beta/security/labels/retentionLabels

Respuesta

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.retentionLabel",
      "id": "64a99fb4-07be-0481-8746-44c15c0eef1f",
      "displayName": "String",
      "behaviorDuringRetentionPeriod": "String",
      "actionAfterRetentionPeriod": "String",
      "retentionTrigger": "String",
      "retentionDuration": {
        "@odata.type": "microsoft.graph.security.retentionDuration"
      },
      "isInUse": "Boolean",
      "descriptionForAdmins": "String",
      "descriptionForUsers": "String",
      "createdBy": {
        "@odata.type": "microsoft.graph.identitySet"
      },
      "createdDateTime": "String (timestamp)",
      "lastModifiedBy": {
        "@odata.type": "microsoft.graph.identitySet"
      },
      "lastModifiedDateTime": "String (timestamp)",
      "labelToBeApplied": "String",
      "defaultRecordBehavior": "String"
    }
  ]
}