Obter estatísticas de relacionamento de administrador delegado
Aplica-se a: Partner Center
Retorna informações sobre a contagem de relações de Administrador Delegado (DAP) estabelecidas ou ativas associadas a um parceiro em todos os seus clientes.
Finalidade: os parceiros estão em conformidade para gerenciar com segurança o locatário do cliente e remover relacionamentos de DAP inativos que ultrapassam 90 dias usando o Remover um relacionamento de DAP com um cliente - desenvolvedor do aplicativo Partner Center.
Essa API ajuda a controlar as estatísticas de DAPs ativos para que os parceiros possam fazer a transição de DAPs ativos para GDAP (Granular delegated Admin Privileges).
Nota
Essa API é de curta duração e terá suporte durante a fase de descontinuação do DAP. Após o programa de descontinuação do DAP, essa API será desativada.
Pré-requisitos
Credencial
Este cenário suporta autenticação apenas com credenciais App+User.
Troca de tokens para receber token de acesso
Para obter mais informações, consulte Configurar um aplicativo para acessar uma API da Web.
Crie uma entidade de serviço para o aplicativo da API de Administração Delegada do Cliente Parceiro no locatário parceiro executando os seguintes comandos a partir de um console do PowerShell.
Conecte-se ao Microsoft Entra ID.
Connect-MgGraph
Exemplo: migrar do Azure AD PowerShell para o Microsoft Graph PowerShell. Para saber mais, consulte Introdução ao SDK do Microsoft Graph PowerShell.
Isso abre uma janela interativa para entrar. Insira as credenciais do locatário parceiro de área restrita.
Em seguida, crie uma nova entidade de serviço:
New-MgServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91
Para saber mais, consulte New-MgServicePrincipal (Microsoft.Graph.Applications).
ObjectId AppId DisplayName C1BF31DA-09E5-4985-AB50-3232D4AE4F5A 2832473f-ec63-45fb-976f-5d45a7d4bb91 Administração delegada de clientes parceiros Em seguida, você cria um aplicativo no locatário acessando o portal do Azure, depois Registros de aplicativo e, em seguida, Criar um aplicativo cliente público ou Usar um aplicativo existente.
Selecione Exibir permissões>da API Adicionar uma permissão>que minha organização usa
Selecionar Cliente Parceiro Administração>Delegada Permissões>delegadas Adicionar permissões
Conceda consentimento de administrador para esta nova permissão.
Agora você pode usar um token App+User (com recurso https://api.partnercustomeradministration.microsoft.com
) usando este aplicativo (com um administrador locatário conectado) para chamar as APIs 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>
Pedido REST
Sintaxe da solicitação
Método | URI do pedido |
---|---|
GET | https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminStatistics |
Parâmetro URI
Nenhum parâmetro de URI necessário para esta API.
Cabeçalhos do pedido
Cabeçalho | Description | valor |
---|---|---|
Autorização | O token de autorização no formato Portador <token> . |
String |
Corpo do pedido
Não forneça um corpo de solicitação para esta API.
Exemplo de solicitação
GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/ delegatedAdminStatistics
HTTP/1.1
Authorization: Bearer \<token\>
Content-Type: application/json; charset=utf-8
Resposta do REST
Se bem-sucedido, esse método retorna uma coleção de recursos delegatedAdminStatistics no corpo da resposta.
Códigos de sucesso e erro de resposta
Cada resposta vem com um código de status HTTP que indica sucesso ou falha e outras informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.
recurso delegatedAdminStatistics
Representa o objeto que contém estatísticas do uso de relações de Privilégio de Administrador Delegado (DAP).
_Propriedades
Property | Type | Descrição |
---|---|---|
id | String | O identificador exclusivo do locatário parceiro. |
partnerTenantId | String | O identificador exclusivo do locatário parceiro. |
totalDapCustomerCount | Int | O número total de clientes com acesso DAP. |
estabelecidoDapCount | coleção delegatedAdminAccessCount | O número de DAPs estabelecidos (criados) e Data de criação. Exemplo: Se 10 DAPs criados em 18/06/2021, a resposta incluiria "contar" como 10 e "data" como "18/06/2021". |
inativoDapCount | coleção delegatedAdminAccessCount | A contagem de clientes que tiveram entradas com a última data de entrada. Exemplo: Se o(s) parceiro(s) entrar(em) em 10 clientes locatário em 18/06/2021, a resposta incluiria "contar" como 10 e "data" como "18/06/2021". |
recurso delegatedAdminAccessCount
Representa a contagem de administradores delegados por dia.
Propriedade | Type | Description |
---|---|---|
Data | String | A data da ação [estabelecida ou assinada]. |
Count | Int | A contagem de clientes. |
Exemplo de resposta
{
"@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
}
]
}