Obtener estadísticas de relaciones de administrador delegadas

Se aplica a: Centro de partners

Devuelve información sobre el recuento de relaciones Administración delegadas (DAP) establecidas o activas asociadas a un asociado en todos sus clientes.

Propósito: los partners son compatibles para administrar de forma segura el inquilino del cliente y quitar relaciones DAP inactivas que superan los 90 días mediante la eliminación de una relación daP con un cliente: desarrollador de aplicaciones del Centro de partners.

Esta API ayuda a realizar un seguimiento de las estadísticas de los DAP activos para que los asociados puedan realizar la transición de DAP activos a privilegios de administrador delegados granulares (GDAP).

Nota:

Esta API es de corta duración y se admitirá durante la fase de desuso de DAP. Después del programa de desuso de DAP, esta API se retirará.

Requisitos previos

Credenciales

Este escenario admite la autenticación solo con credenciales de aplicación y usuario.

Intercambio de tokens para recibir el token de acceso

Para más información, consulte Configuración de una aplicación para acceder a una API web.

Cree una entidad de servicio para la aplicación de API delegada de Administración istration del cliente asociado en el inquilino del asociado ejecutando los siguientes comandos desde una consola de PowerShell.

1. Conectar a Microsoft Entra ID.

   Connect-MgGraph

   Ejemplo: Migración de Azure AD PowerShell a Microsoft Graph PowerShell. Para más información, consulte Introducción al SDK de PowerShell de Microsoft Graph.

   Se abre una ventana interactiva para iniciar sesión. Escriba las credenciales del inquilino del asociado de espacio aislado.

2. A continuación, cree una nueva entidad de servicio: New-MgServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91

   Para obtener más información, consulte New-MgServicePrincipal (Microsoft.Graph.Applications) .

   ObjectId	AppId	Nombre para mostrar
   c1bf31da-09e5-4985-ab50-3232d4ae4f5a	2832473f-ec63-45fb-976f-5d45a7d4bb91	Administración istration delegado del cliente asociado

3. A continuación, cree una aplicación en el inquilino; para ello, vaya a Azure Portal y, a continuación, Registros de aplicaciones, cree una aplicación cliente pública o Use an existing app (Usar una aplicación existente).

4. Seleccione Ver permisos>de API Agregar una API de permisos>que usa mi organización.

5. Seleccione Partner Customer Delegated Administración istration Delegated permissions Add permissions (Agregar permisos>)>

6. Conceda el consentimiento del administrador para este nuevo permiso.

Ahora puede usar un token de app+user (con el recurso https://api.partnercustomeradministration.microsoft.com) mediante esta aplicación (con un administrador de inquilinos que ha iniciado sesión) para llamar a las API de GDAP.

POST https://login.microsoftonline.com/<partner_tenant_id>/oauth2/token grant_type=client_credentials&scope:https://api.partnercustomeradministration.microsoft.com&client_id:<client_id>&client_secret:<client_secret>

Solicitud REST

Sintaxis de la solicitud

Método	URI de solicitud
GET	https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminStatistics

Parámetro de URI

No se requieren parámetros de URI para esta API.

Encabezados de solicitud

Encabezado	Descripción	Value
Authorization	Token de autorización con el formato Bearer <token>.	Cadena

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para esta API.

Ejemplo de solicitud

GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/ delegatedAdminStatistics  
HTTP/1.1 
Authorization: Bearer \<token\> 
Content-Type: application/json; charset=utf-8 

Respuesta REST

Si se ejecuta correctamente, este método devuelve una colección de recursos delegados Administración Statistics en el cuerpo de la respuesta.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

recurso delegated Administración Statistics

Representa el objeto que contiene estadísticas del uso de relaciones de privilegios delegados Administración (DAP).

Propiedades

Propiedad	Tipo	Descripción
id	Cadena	Identificador único del inquilino del asociado.
partnerTenantId	Cadena	Identificador único del inquilino del asociado.
totalDapCustomerCount	Int	Número total de clientes con acceso DAP.
establishedDapCount	colección delegated Administración AccessCount	Número de DAP establecidos (creados) y Fecha de creación. Ejemplo: si 10 DAP creados el 18/6/2021, la respuesta incluiría "count" como 10 y "date" como "6/18/2021".
inactiveDapCount	colección delegated Administración AccessCount	Recuento de clientes que han tenido inicios de sesión con la última fecha de inicio de sesión. Ejemplo: Si los asociados han iniciado sesión en 10 clientes en el inquilino del 18/6/18/2021, la respuesta incluiría "count" como 10 y "date" como "6/18/2021".

recurso delegated Administración AccessCount

Representa el recuento de administradores delegados por día.

Propiedad	Tipo	Descripción
Date	Cadena	Fecha de la acción [establecida o iniciada].
Count	Int	Recuento de clientes.

Ejemplo de respuesta

{ 

  "@odata.context": "https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/$metadata#delegatedAdminStatistics/$entity", 

  "id": "8984fecd-00a2-4686-ba43-b5c20866944a", 

  "partnerTenantId": "8984fecd-00a2-4686-ba43-b5c20866944a", 

  "totalDapCustomerCount": 200, 

  "establishedDapCount": [ 

    { 

      "date": "6/18/2021", 

      "count": 1 

    }, 

    { 

      "date": "2/18/2022", 

      "count": 1 

    } 

  ], 

  "inactiveDapCount": [ 

    { 

      "date": "2/18/2022", 

      "count": 1  

    }, 

    { 

      "date": "2/24/2022", 

      "count": 1 

    } 

  ] 

}