Eventos webhook do Partner Center

Aplica-se: Centro de Parceiros | Centro Parceiro operado pela 21Vianet | Centro de Parceiros para Microsoft Cloud para o Governo dos EUA

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 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 suporta os eventos de webhook abaixo.

Evento de teste

Este evento permite-lhe auto-integrar e testar o seu registo, solicitando um evento de teste e, em seguida, acompanhando o seu progresso. Pode ver as mensagens de falha que estão a ser recebidas da Microsoft enquanto tenta entregar o evento. Isso só se aplica 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"
}

Subscrição de Evento Ativo

Esse evento é gerado quando a assinatura é ativada. Atualmente, esse evento está disponível apenas para locatários da 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 de Subscrição Pendente

Este evento é gerado quando a assinatura está pendente. Atualmente, esse evento está disponível apenas para locatários da 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 subscrição

Esse evento é gerado quando a assinatura é renovada. Atualmente, esse evento está disponível apenas para locatários da 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 de Atualização de Subscrição

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

Este evento é elevado quando a quantidade de utilização do Microsoft Azure por qualquer cliente ultrapassa o seu orçamento de despesa (o seu limiar). Para mais informações, consulte [Definir um orçamento de gastos do Azure para os seus clientes/partner-center/definir-um-orçamento-de-gastos-do-azure-para-os-seus-clientes).

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 referência

Este 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

Este evento é acionado 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

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

Evento de Aprovação da Relação Detalhada do Administrador

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 de Ativação de Relacionamento de Administração Granular

Este evento é gerado quando os Privilégios de Administrador Delegado Granular são criados e ficam ativos para a aprovação do cliente.

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 de Término 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 de Extensão Automática de Relacionamento Granular de Administrador

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 do relacionamento granular com o administrador

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

Evento de Expiração da Relação do Administrador Granular

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 pelo Granular Admin Relationship

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

Esse evento é gerado quando o parceiro criou a atribuição de acesso de privilégios de administrador delegado granular. Os parceiros podem atribuir funções 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 de Activação de Atribuição Granular de Acesso de Administrador

Este evento é ativado quando o parceiro atribui papéis do Microsoft Entra aos grupos de segurança específicos e ativa a atribuição de acesso aos 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 de atribuição de acesso granular de administrador atualizado

Este evento é acionado quando o parceiro atualiza a atribuição de acesso de 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 Eliminado da Atribuição Granular de Acesso de Administrador

Este evento é gerado quando o parceiro elimina a atribuição de acesso dos Privilégios Granulares de Administrador Delegado.

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 de Migração Completa para Novo Comércio

Este evento é acionado quando a migração de comércio novo é 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"

Este evento é acionado quando a migração de comércio novo é 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

Este evento é gerado quando a migração para o novo comércio falha e não foi possível 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 de Falha na Programação de Migração do Novo Comércio

Esse evento é gerado quando o cronograma 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

Este 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 Falha de Transferência

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

Evento "DownloadRequestCreated"

Este evento é ativado quando é criado um novo pedido de download.

Propriedades

Exemplo

{
    "EventName": "download-request-created",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/transact/downloads/{download_id}
    "ResourceName": " Download",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Evento DownloadRequest Concluído

Este evento é ativado quando um novo pedido de download é concluído.

Propriedades

Exemplo

{
    "EventName": "download-request-completed",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/transact/downloads/{download_id}
    "ResourceName": " Download",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

Aceitação do relacionamento com o revendedor pelo evento do cliente

Este 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/aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "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"
}

Aceitação da relação com o revendedor indireto no evento do cliente

Esse evento é gerado quando o locatário do cliente aprova o Relacionamento de Revendedor Indireto.

Propriedades

Exemplo

{
  "EventName": "indirect-reseller-relationship-accepted-by-customer",
  "ResourceUri": "https://api.partnercenter.microsoft.com/v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "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 DAP Terminada por Evento da Microsoft

Este evento surge quando a Microsoft termina o DAP entre o Parceiro e o 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 para 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"
}

Relação de administrador do DAP encerrada

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"

}

Azure Evento de Fraude Detetado

Esse evento é gerado quando o locatário Parceiro tem algum alerta de segurança detetado em 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

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