Compartir a través de

Enumerar los clientes administradores delegados de un asociado

  • Artículo

Se aplica a: Centro de partners

Devuelve una lista de todos los clientes de un asociado, que también indica si los clientes tienen una relación DAP o no DAP.

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.

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

    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

    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/delegatedAdminCustomers

Parámetro de URI

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

Encabezados de solicitud

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

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para esta API.

Parámetros de consulta opcionales

Este método admite los $selectcampos , $filter, $skip$top$county $orderBy (permitidos: organizationDisplayName, dapEnabled, startDateTime, lastSignInDateTime) para ayudar a personalizar la respuesta.

$top admite hasta 300 objetos.

Ejemplo de solicitud

GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminCustomers 
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 Customers 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 Customers

Representa un cliente administrador delegado de un asociado y los detalles sobre el acceso del asociado al inquilino del cliente.

Propiedades

Propiedad Tipo Descripción
id Cadena Identificador único del inquilino del cliente.
customerTenantId Cadena Identificador único del inquilino del cliente.
OrganizationDisplayName Cadena Nombre para mostrar de la organización del cliente.
partnerAgentCount Int Recuento de asociados que han iniciado sesión en el inquilino del cliente en el último día.
partnerSignInCount Int Número de veces que los asociados han iniciado sesión en el inquilino del cliente en el último día.
dapEnabled Booleano El valor indica si el asociado tiene una relación DAP para el cliente.
Si es False: la relación DAP no existe para ese cliente.
Si es True: existe una relación DAP para ese cliente
startDateTime Cadena Fecha y hora en que se estableció la relación DAP.
endDateTime Cadena Se finalizó la fecha y hora de la relación DAP.
lastSignInDateTime Cadena La última hora de inicio de sesión del asociado en este inquilino del cliente.
Null/empty: no hay inicios de sesión en el inquilino del cliente por parte de los asociados.

Ejemplo de respuesta

{ 

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

    "value": [ 

        { 

            "id": "53018d99-ac51-4ec8-b86e-c8a61de43717", 

            "customerTenantId": "53018d99-ac51-4ec8-b86e-c8a61de43717", 

            "organizationDisplayName": "Test_Test_GAA_Partner_Account", 

            "partnerAgentCount": 0, 

            "partnerSignInCount": 0, 

            "globalAdminSignInCount": 0, 

            "dapEnabled": false, 

            "startDateTime": "2021-08-06T21:15:04.3461507Z", 

            "endDateTime": null, 

            "lastSignInDateTime": null 

        }, 

        { 

            "id": "6fc468f5-b399-4e05-a6f1-da8a33da9a6c", 

            "customerTenantId": "6fc468f5-b399-4e05-a6f1-da8a33da9a6c", 

            "organizationDisplayName": "StagingTest", 

            "partnerAgentCount": 0, 

            "partnerSignInCount": 0, 

            "globalAdminSignInCount": 0, 

            "dapEnabled": true, 

            "startDateTime": "2022-04-20T06:11:11.7227953Z", 

            "endDateTime": null, 

            "lastSignInDateTime": "2022-04-20T06:11:11.7227953Z" 

        } 
] 
}