Eventos webhook do Partner Center
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government
Os eventos webhook do Partner Center são eventos de alteração de recursos entregues na forma de HTTP POSTs para uma URL registrada. Para receber um evento do Partner Center, você hospeda um retorno de chamada onde o Partner Center pode POSTAR o evento. O evento é assinado digitalmente para que você possa validar que foi enviado do Partner Center.
Para obter informações sobre como receber eventos, autenticar um retorno de chamada e usar as APIs de webhook do Partner Center para criar, exibir e atualizar um registro de evento, consulte Webhooks do Partner Center.
Eventos Suportados
O Partner Center oferece suporte aos eventos de webhook abaixo.
Evento de teste
Esse evento permite que você se auto-integre e teste seu registro solicitando um evento de teste e, em seguida, acompanhe seu progresso. Você pode ver as mensagens de falha que estão sendo recebidas da Microsoft ao tentar entregar o evento. Isso só se aplica a eventos "criados por teste" e os dados com mais de sete dias são limpos.
Observação
Um limite de aceleração de 2 solicitações por minuto é imposto ao postar um evento criado por teste.
Propriedades
Exemplo
{
"EventName": "test-created",
"ResourceUri": "http://api.partnercenter.microsoft.com/webhooks/v1/registration/validationEvents/{{CorrelationId}}",
"ResourceName": "test",
"AuditUri": null,
"ResourceChangeUtcDate": "2017-11-16T16:19:06.3520276+00:00"
}
Evento Atualizado de Assinatura
Esse evento é gerado quando a assinatura especificada é alterada. Um evento Subscription Updated é gerado quando há uma alteração interna, além de quando as alterações são feitas por meio da API do Partner Center. Esse evento só é gerado quando há alterações no nível de comércio, por exemplo, quando o número de licenças é modificado e quando o estado da assinatura é alterado. Ele não será gerado quando os recursos forem criados dentro da assinatura.
Observação
Há um atraso de até 48 horas entre o momento em que uma assinatura é alterada e quando o evento Assinatura Atualizada é acionado.
Propriedades
Exemplo
{
"EventName": "subscription-updated",
"ResourceUri": "http://api.partnercenter.microsoft.com/webhooks/v1/customers/{{CustomerId}}/subscriptions/{{SubscriptionId}}",
"ResourceName": "subscription",
"AuditUri": "https://api.partnercenter.microsoft.com/v1/auditrecords/{{AuditId}}",
"ResourceChangeUtcDate": "2017-11-16T16:19:06.3520276+00:00"
}
Evento de limite excedido
Esse evento é gerado quando a quantidade de uso do Microsoft Azure para qualquer cliente excede seu orçamento de gastos de uso (seu limite). Para obter mais informações, consulte [Definir um orçamento de gastos do Azure para seus clientes/partner-center/set-an-azure-spending-budget-for-your-customers).
Propriedades
| Propriedade | Type | Descrição |
|---|---|---|
| EventName | string | O nome do evento. No formato {resource}-{action}. Para esse evento, o valor é usagerecords-thresholdExceededed. |
| ResourceUri | URI | O URI para obter o recurso. Usa a sintaxe: "{baseURL}/webhooks/v1/customers/usagerecords" |
| ResourceName | string | O nome do recurso que dispara o evento. Para esse evento, o valor é usagerecords. |
| AuditUri | URI | (Opcional) O URI para obter o registro de auditoria, se ele existir. Usa a sintaxe: "{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}" |
| ResourceChangeUtcDate | cadeia de caracteres no formato de data-hora UTC | A data e a hora em que a alteração de recurso ocorreu. |
Exemplo
{
"EventName": "usagerecords-thresholdExceeded",
"ResourceUri": "https://api.partnercenter.microsoft.com/v1/customers/usagerecords",
"ResourceName": "usagerecords",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento criado por referência
Esse evento é gerado quando a referência é criada.
Propriedades
Exemplo
{
"EventName": "referral-created",
"ResourceUri": "https://api.partnercenter.microsoft.com/engagements/v1/referrals/{{ReferralID}}",
"ResourceName": "referral",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento atualizado de referência
Esse evento é gerado quando a referência é atualizada.
Propriedades
Exemplo
{
"EventName": "referral-updated",
"ResourceUri": "https://api.partnercenter.microsoft.com/engagements/v1/referrals/{{ReferralID}}",
"ResourceName": "referral",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento atualizado de referência relacionado
Esse evento é gerado quando a referência relacionada é atualizada.
Propriedades
Exemplo
{
"EventName": "related-referral-updated",
"ResourceUri": "https://api.partnercenter.microsoft.com/engagements/v1/referrals/{{ReferralID}}",
"ResourceName": "referral",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento criado por referência relacionada
Esse evento é gerado quando a referência relacionada é criada.
Propriedades
Exemplo
{
"EventName": "related-referral-created",
"ResourceUri": "https://api.partnercenter.microsoft.com/engagements/v1/referrals/{{ReferralID}}",
"ResourceName": "referral",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento Aprovado de Relacionamento Administrador Granular
Esse evento é gerado quando o cliente aprova os privilégios de administrador delegado granular.
Propriedades
Exemplo
{
"EventName": "granular-admin-relationship-approved",
"ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
"ResourceName": "GranularAdminRelationship",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento Granular Admin Relationship Activated
Esse evento é gerado quando os Privilégios de administrador delegado granular são criados e ativos para o cliente aprovar.
Propriedades
Exemplo
{
"EventName": "granular-admin-relationship-activated",
"ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
"ResourceName": "GranularAdminRelationship",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento Encerrado de Relacionamento de Administração Granular
Esse evento é gerado quando o parceiro ou cliente encerra os Privilégios de Administrador Delegado Granular.
Propriedades
Exemplo
{
"EventName": "granular-admin-relationship-terminated",
"ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
"ResourceName": "GranularAdminRelationship",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento Granular Admin Relationship Expired
Esse evento é gerado quando os privilégios de administrador delegado granular expiram.
Propriedades
Exemplo
{
"EventName": "granular-admin-relationship-expired",
"ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
"ResourceName": "GranularAdminRelationship",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento criado de atribuição de acesso de administrador granular
Esse evento é gerado quando o parceiro criou a atribuição de acesso Privilégios de Administrador Delegado Granular. Os parceiros podem atribuir funções do Microsoft Entra aprovadas pelo cliente a grupos de segurança específicos.
Propriedades
Exemplo
{
"EventName": "granular-admin-access-assignment-created",
"ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}/accessAssignments/{{AssignmentID}}",
"ResourceName": "GranularAdminAccessAssignment",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento Granular Admin Access Assignment Activated
Esse evento é gerado quando o parceiro atribui as funções do Microsoft Entra aos grupos de segurança específicos e ativa a atribuição de acesso Privilégios de Administrador Delegado Granular.
Propriedades
Exemplo
{
"EventName": "granular-admin-access-assignment-activated",
"ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}/accessAssignments/{{AssignmentID}}",
"ResourceName": "GranularAdminAccessAssignment",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento Atualizado de Atribuição de Acesso de Administrador Granular
Esse evento é gerado quando o parceiro atualiza a atribuição de acesso Privilégios de Administrador Delegado Granular.
Propriedades
Exemplo
{
"EventName": "granular-admin-access-assignment-updated",
"ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}/accessAssignments/{{AssignmentID}}",
"ResourceName": "GranularAdminAccessAssignment",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento Excluído de Atribuição de Acesso de Administrador Granular
Esse evento é gerado quando o parceiro exclui a atribuição de acesso Privilégios de Administrador Delegado Granular.
Propriedades
Exemplo
{
"EventName": "granular-admin-access-assignment-deleted",
"ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}/accessAssignments/{{AssignmentID}}",
"ResourceName": "GranularAdminAccessAssignment",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento CreateNewCommerceMigration
Esse evento é gerado quando a migração de novo comércio é criada e o processo de migração é iniciado.
Propriedades
Exemplo
{
"EventName": "new-commerce-migration-created",
"ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/{migrationId},
"ResourceName": " NewCommerceMigration",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento CompleteNewCommerceMigration
Esse evento é gerado quando a migração de novo comércio é concluída com êxito. A assinatura herdada é cancelada e a nova assinatura de comércio é criada.
Propriedades
Exemplo
{
"EventName": "new-commerce-migration-completed",
"ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/{migrationId},
"ResourceName": " NewCommerceMigration",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento NewCommerceMigrationFailed
Esse evento é gerado quando a migração do novo comércio falha e não conseguimos criar a nova assinatura de comércio.
Propriedades
Exemplo
{
"EventName": "new-commerce-migration-failed",
"ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/{migrationId},
"ResourceName": " NewCommerceMigration",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento NewCommerceMigrationScheduleFailed
Esse evento é gerado quando a agenda de migração de novo comércio falha para que o registro de migração não seja criado. Agendamentos de migração que falham também significam que a migração não acontece.
Propriedades
Exemplo
{
"EventName": "new-commerce-migration-schedule-failed",
"ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/schedules/{scheduleId},
"ResourceName": " NewCommerceMigrationSchedule",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Relacionamento com revendedor aceito por evento do cliente
Esse evento é gerado quando um cliente aceita um relacionamento de revendedor.
Propriedades
Exemplo
{
"EventName": "reseller-relationship-accepted-by-customer",
"ResourceUri": "https://api.partnercenter.microsoft.com/v1/customers/4b2a6e33-8791-4386-bd2b-0d55baf25039",
"ResourceName": "Customer",
"AuditUri": "https://api.partnercenter.microsoft.com/auditactivity/v1/auditrecords/60d5c4bb-f78a-4200-a002-953d7cc1f5f8_4b2a6e33-8791-4386-bd2b-0d55baf25039_resellerrelationshipacceptedbycustomer_638331855840159088",
"ResourceChangeUtcDate": "2023-10-18T00:26:24.0159088+00:00"
}
Relação de administrador do DAP encerrada por evento da Microsoft
Esse evento é gerado quando a Microsoft encerra o DAP entre o locatário Parceiro e Cliente quando o DAP está inativo por mais de 90 dias.
Propriedades
Exemplo
{
"EventName": "dap-admin-relationship-terminated-by-microsoft",
"ResourceName": "PartnerCustomerDap",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento aprovado de relacionamento de administrador do DAP
Esse evento é gerado quando o DAP entre o locatário Parceiro e Cliente é aprovado.
Propriedades
Exemplo
{
"EventName": "dap-admin-relationship-approved",
"ResourceName": "PartnerCustomerDap",
"AuditUri": null,
"ResourceUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Relação de administrador do DAP encerrada
Esse evento é gerado quando o DAP entre o locatário Parceiro e Cliente é encerrado.
Propriedades
Exemplo
{
"EventName": "dap-admin-relationship-terminated",
"ResourceName": "PartnerCustomerDap",
"AuditUri": null,
"ResourceUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Evento de Fraude do Azure Detectado
Esse evento é gerado quando o locatário do Parter tem qualquer alerta de segurança detectado para qualquer um dos locatários clientes do parceiro CSP. Os Parceiros CSP são obrigados a tomar medidas para resolver o alerta de Segurança imediatamente.
Propriedades
| Propriedade | Type | Descrição |
|---|---|---|
| EventName | string | O nome do evento. No formato {resource}-{action}. Para esse evento, o valor é azure-fraud-event-detected. |
| ResourceUri | URI | O URI para obter o recurso. Usa a sintaxe: "{baseURL}/v1/customers/{{customerId}}/subscriptions/{{subscriptionId}}" |
| AuditUri | URI | (Opcional) O URI para obter o registro de auditoria, se ele existir. Usa a sintaxe: "{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}" |
| ResourceChangeUtcDate | cadeia de caracteres no formato de data-hora UTC | A data e a hora em que a alteração de recurso ocorreu. |
Exemplo
{
"EventName": "azure-fraud-event-detected",
"ResourceUri": "https://api.partnercenter.microsoft.com/v1/customers/{{customerId}}/subscriptions/{{subscriptionId}} ",
"AuditUri": null,
"ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de