Eventos de 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 de 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 em que o Partner Center pode POSTAR o evento. O evento é assinado digitalmente para que você possa validar se ele 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 com suporte

O Partner Center dá suporte aos eventos de webhook abaixo.

Evento de teste

Este evento permite que você se auto-integre e teste seu registro solicitando um evento de teste e acompanhando seu progresso. Você pode ver as mensagens de falha que estão sendo recebidas da Microsoft ao tentar entregar o evento. Isso se aplica apenas a eventos "criados por teste" e os dados com mais de sete dias são limpos.

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 ativo de assinatura

Esse evento é gerado quando a assinatura é ativada. No momento, esse evento está disponível apenas para locatários do Sandbox.

Propriedades

Exemplo

{
    "EventName": "subscription-active",
    "ResourceUri": "http://api.partnercenter.microsoft.com/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 pendente de assinatura

Esse evento é gerado quando a assinatura está pendente. No momento, esse evento está disponível apenas para locatários do Sandbox.

Propriedades

Exemplo

{
    "EventName": "subscription-pending",
    "ResourceUri": "http://api.partnercenter.microsoft.com/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 renovação de assinatura

Esse evento é gerado quando a assinatura é renovada. No momento, esse evento está disponível apenas para locatários do Sandbox.

Propriedades

Exemplo

{
    "EventName": "subscription-renewed",
    "ResourceUri": "http://api.partnercenter.microsoft.com/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 atualizado de assinatura

Esse evento é gerado quando a assinatura especificada é alterada. Um evento de Assinatura Atualizada é 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.

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

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 indicação

Esse evento é gerado quando a indicação é 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 indicação

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 indicação 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 de Criação de Referência Relacionado

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"
}

Granular Admin Relationship Approved Event

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 ativado de relacionamento de administrador granular

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 administrador 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"
}

Granular Admin Relationship Evento Estendido Automático

Esse evento é gerado quando o sistema estende automaticamente os privilégios de administrador delegado granular.

Propriedades

Exemplo

{
    "EventName": "granular-admin-relationship-auto-extended",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Evento atualizado de relacionamento de administrador granular

Esse evento é gerado quando o cliente ou parceiro atualiza os Privilégios de Administrador Delegado Granular.

Propriedades

Exemplo

{
    "EventName": "granular-admin-relationship-updated",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Granular Admin Relationship Expired Event

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"
}

Granular Admin Relationship Created Event

Esse evento é gerado quando os Privilégios de Administrador Delegado Granular são criados.

Propriedades

Exemplo

{
    "EventName": "granular-admin-relationship-created",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Evento de atribuição de acesso de administrador granular criado

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 ativado de atribuição de acesso de administrador granular

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 Granular Delegated Admin Privileges.

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 CreateNewCommerceMigration

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": "create-new-commerce-migration-schedule",
    "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 de 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 o agendamento de migração de novo comércio falha, portanto, o registro de migração não é criado. Os 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"
}

Evento CreateTransfer

Esse evento é gerado quando uma nova transferência é criada.

Propriedades

Exemplo

{
    "EventName": "create-transfer",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Evento ExpireTransfer

Esse evento é gerado quando uma nova transferência expira.

Propriedades

Exemplo

{
    "EventName": "expire-transfer",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Evento UpdateTransfer

Esse evento é gerado quando uma nova transferência é atualizada.

Propriedades

Exemplo

{
    "EventName": "update-transfer",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Evento CompleteTransfer

Esse evento é gerado quando a transferência é concluída.

Propriedades

Exemplo

{
    "EventName": "complete-transfer",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Evento FailTransfer

Esse evento é gerado quando a transferência falha.

Propriedades

Exemplo

{
    "EventName": "transfer-failed",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Relacionamento de revendedor aceito pelo evento do cliente

Esse evento é gerado quando um cliente aceita uma relação 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 revendedor indireto aceita pelo evento do cliente

Esse evento é gerado quando o locatário do cliente aprova a Relação de Revendedor Indireto.

Propriedades

Exemplo

{
  "EventName": "indirect-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"
}

Relacionamento de administrador do DAP encerrado por evento da Microsoft

Esse evento é gerado quando a Microsoft encerra o DAP entre o locatário do Parceiro e do 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 do Parceiro e do Cliente é aprovado.

Propriedades

Exemplo

{
    "EventName": "dap-admin-relationship-approved",
    "ResourceName": "PartnerCustomerDap",
    "AuditUri": null,
    "ResourceUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Relacionamento de administrador do DAP encerrado

Esse evento é gerado quando o DAP entre o locatário do Parceiro e do 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 Evento Detectado

Esse evento é gerado quando o locatário do Parter tem qualquer alerta de segurança detectado para qualquer um dos locatários do cliente do Parceiro CSP. Os parceiros CSP devem tomar medidas para resolver o alerta de segurança imediatamente.

Propriedades

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"
}