Preencha o pré-requisito para monitorar eventos Configure EventBridge a Amazon para monitorar eventos Saiba mais sobre os eventos da API de benefícios

Notificações para o AWS API de benefícios do Partner Central

O Serviço de Benefícios oferece EventBridge eventos para BenefitApplications BenefitAllocations e. Esses eventos permitem que os clientes criem arquiteturas abrangentes orientadas por eventos que respondem às mudanças em todo o ciclo de vida dos recursos, desde a aplicação inicial até a alocação e o atendimento final.

Tópicos

Preencha o pré-requisito para monitorar eventos
Configure EventBridge a Amazon para monitorar eventos
Saiba mais sobre os eventos da API de benefícios

Preencha o pré-requisito para monitorar eventos

Os usuários precisam das permissões apropriadas do IAM para acessar e gerenciar eventos publicados pela API de benefícios. Para obter mais informações sobre as ações, os recursos e as chaves de condição disponíveis para EventBridge, consulte Usando as condições da política do IAM na Amazon EventBridge no Guia EventBridge do usuário da Amazon. Uma das chaves de condição éevents:detail-type, que pode ser usada para definir permissões para tipos específicos de eventos.

O exemplo de política a seguir demonstra como personalizar e definir o escopo das permissões para os eventos propostos. A AllowPutRuleForPartnercentralBenefitsEvents declaração permite a criação de regras, mas somente para eventos da aws.partnercentral-benefits fonte.

Para exemplos detalhados de políticas do IAM, consulte a documentação da AWS sobre EventBridge permissões.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowPutRuleForPartnerCentralBenefitsEvents",
      "Effect": "Allow",
      "Action": "events:PutRule",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "events:source": "aws.partnercentral-benefits"
        }
      }
    }
  ]
}

Configure EventBridge a Amazon para monitorar eventos

Para monitorar eventos da API de benefícios, você cria uma EventBridge regra que corresponde aos eventos que você deseja capturar. Você pode usar o AWS Management Console ou os AWS SDKs para criar e gerenciar regras. As seções a seguir explicam como criar regras usando os dois métodos. Independentemente do método usado, você deve criar a regra na us-east-1 região Leste dos EUA (Norte da Virgínia).

AWS Management Console configuração

Para configurar uma EventBridge regra usando o AWS Management Console, siga as etapas em Criação de regras que reagem a eventos na Amazon EventBridge no Guia EventBridge do usuário da Amazon. Ao criar a regra, você deve definir o barramento de eventos como padrão e criar a regra na us-east-1 região Leste dos EUA (Norte da Virgínia).

Veja a seguir um exemplo de uma regra de evento:


{
    "source": ["aws.partnercentral-benefits"],
    "detail": {
        "catalog": ["AWS"]
    }
}

AWS Configuração do SDK

Você pode usar os AWS SDKs para criar e gerenciar EventBridge regras de forma programática. Para obter mais informações, consulte PutRulea Amazon EventBridge API Reference.

O exemplo a seguir usa o AWS SDK para Python (Boto3):


import boto3

client = boto3.client('events', region_name='us-east-1')

response = client.put_rule(
    Name='MyBenefitApplicationCreatedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-benefits"], 
        "detail-type": ["Benefit Application Created"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

Saiba mais sobre os eventos da API de benefícios

As seções a seguir descrevem os tipos de eventos da API de benefícios, os cenários que os acionam e os exemplos de eventos.

Tipos de eventos

A seguir estão os tipos de eventos e seus gatilhos.

Aplicações de benefícios

Aplicativo de benefícios criado: quando um aplicativo de benefícios é criado
Solicitação de benefícios em análise: Quando uma solicitação de benefício é enviada ou quando a solicitação passa da Ação necessária para A análise, esse evento é acionado.
Ação de solicitação de benefícios necessária: Esse evento ocorre quando um revisor interno atualiza o status da inscrição para indicar que o parceiro precisa fornecer informações adicionais, esclarecimentos ou modificações antes que a análise possa continuar.
Solicitação de benefícios rejeitada: esse evento ocorre quando um revisor interno atualiza o status da solicitação para indicar que a solicitação não atende aos critérios ou requisitos do benefício e foi recusada
Solicitação de benefícios aprovada: Esse evento ocorre quando um revisor interno atualiza o status da solicitação para indicar que a solicitação foi aprovada para alocação de benefícios.
Estágio de solicitação de benefícios alterado: Esse evento ocorre quando um revisor interno atualiza o estágio da solicitação durante processos de revisão, como análise comercial,AWS revisão, análise financeira etc.

Alocações de benefícios

Alocação de benefícios ativada: quando uma alocação de benefícios é criada ou atualizada de volta para Ativada por um serviço interno.
Alocação de benefícios inativada: esse evento ocorre quando um revisor interno atualiza o status da alocação ou quando uma alocação de benefícios expira automaticamente.
Alocação de benefícios cumprida: esse evento ocorre quando um revisor interno atualiza o status da alocação para indicar que a alocação foi totalmente utilizada.

Eventos de exemplo

As seções a seguir fornecem exemplos dos eventos listados anteriormente na seção anterior.

Tópicos

Aplicativo de benefícios criado
Solicitação de benefícios em análise
Ação de solicitação de benefícios necessária
Pedido de benefício rejeitado
Solicitação de benefícios aprovada
Estágio de solicitação de benefícios alterado
Alocação de benefícios ativada
Alocação de benefícios inativada
Alocação de benefícios cumprida

Aplicativo de benefícios criado

Contexto de acionamento

O evento Benefit Application Created é publicado na Amazon EventBridge quando um novo Pedido de Benefícios é criado com sucesso por meio do Serviço de Benefícios. Esse evento ocorre quando a chamada da CreateBenefitApplication API é concluída com êxito, indicando que um parceiro iniciou uma solicitação para um benefício específico.

Esse evento representa o início do ciclo de vida da solicitação de benefícios e fornece aos clientes uma notificação imediata quando novas solicitações são enviadas para suas contas.

Destinatários

A conta proprietária receberá o evento para a alocação de benefícios.

Exemplo


{
  "id": "7gh88765-k0jh-d08g-i292-2ff1796m030n",
  "detail-type": "Benefit Application Created",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-10T15:45:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "PENDING_SUBMISSION",
      "revision": "hh7e8400-e29b-41d4-a716-446655440012"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Solicitação de benefícios em análise

Contexto de acionamento

O evento Benefit Application In Review é publicado na Amazon EventBridge quando um aplicativo de benefícios passa para o status IN_REVIEW por meio do Benefits Service. Esse evento ocorre quando:

Um parceiro envia sua inscrição por meio da SubmitBenefitApplication chamada de API
Um aplicativo faz a transição de ACTION_REQUIRED de volta para IN_REVIEW depois que o parceiro responde ao feedback
Uma solicitação é recuperada e, em seguida, reenviada.

Esse evento indica que a inscrição entrou no processo formal de revisão e está sendo avaliada por equipes AWS internas.

Destinatários

A conta proprietária receberá o evento para a alocação de benefícios.

Exemplo


{
  "id": "8hi99876-l1ki-e19h-j303-3gg2807n141o",
  "detail-type": "Benefit Application In Review",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-10T16:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "IN_REVIEW",
      "stage": "BUSINESS_REVIEW",
      "revision": "ii8f9511-f30c-52e5-b827-557766551123"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Ação de solicitação de benefícios necessária

Contexto de acionamento

O evento Benefit Application Action Required é publicado na Amazon EventBridge quando um aplicativo de benefícios faz a transição para o status ACTION_REQUIRED por meio do Benefits Service. Esse evento ocorre quando um revisor interno atualiza o status do aplicativo por meio da UpdateBenefitApplicationInternal API para indicar que o parceiro precisa fornecer informações adicionais, esclarecimentos ou modificações antes que a análise possa continuar.

Esse evento representa um ponto crítico no ciclo de vida do aplicativo em que a intervenção do parceiro é necessária para levar o aplicativo adiante no processo de análise.

Destinatários

A conta proprietária receberá o evento para a alocação de benefícios

Exemplo


{
  "id": "9ij00987-m2lj-f20i-k414-4hh3918o252p",
  "detail-type": "Benefit Application Action Required",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-12T10:30:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "ACTION_REQUIRED",
      "stage": "BUSINESS_REVIEW",
      "revision": "jj9g0622-g41d-63f6-c938-668877662234"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Pedido de benefício rejeitado

Contexto de acionamento

O evento Solicitação de Benefício Rejeitada é publicado na Amazon EventBridge quando uma Solicitação de Benefício passa para o status REJEITADA por meio do Serviço de Benefícios. Esse evento ocorre quando um revisor interno atualiza o status do aplicativo por meio da UpdateBenefitApplicationInternal API para indicar que o aplicativo não atende aos critérios ou requisitos de benefícios e foi recusado.

Esse evento representa um estado terminal no ciclo de vida do aplicativo em que o aplicativo foi formalmente recusado e não prosseguirá com a alocação de benefícios.

Destinatários

A conta proprietária receberá o evento para a alocação de benefícios.

Exemplo


{
  "id": "0kl11098-n3mk-g31j-l525-5ii4029p363q",
  "detail-type": "Benefit Application Rejected",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-15T14:20:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "REJECTED",
      "revision": "kk0h1733-h52e-74g7-d049-779988773345"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Solicitação de benefícios aprovada

Contexto de acionamento

O evento Solicitação de Benefício Aprovada é publicado na Amazon EventBridge quando uma Solicitação de Benefício passa para o status APROVADO por meio do Serviço de Benefícios. Esse evento ocorre quando um revisor interno atualiza o status do aplicativo por meio da UpdateBenefitApplicationInternal API para indicar que o aplicativo atende a todos os critérios e requisitos de benefícios e foi aprovado para alocação de benefícios.

Esse evento representa uma conclusão bem-sucedida do processo de análise da inscrição e normalmente aciona a criação de uma alocação de benefícios correspondente.

Destinatários

A conta proprietária receberá o evento para a alocação de benefícios.

Exemplo


{
  "id": "1lm22109-o4nl-h42k-m636-6jj5130q474r",
  "detail-type": "Benefit Application Approved",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-14T16:45:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "APPROVED",
      "revision": "ll1i2844-i63f-85h8-e150-880099884456"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Estágio de solicitação de benefícios alterado

Contexto de acionamento

O evento Benefit Application Stage Changed é publicado na Amazon EventBridge quando o estágio de análise de um pedido de benefícios é atualizado por meio do Serviço de Benefícios. Esse evento ocorre quando um revisor interno atualiza o estágio do aplicativo para um dos possíveis valores de Enum (FINANCE_REVIEW, BUSINESS_REVIEW, TECH_REVIEW e _REVIEW).AWS

Diferentemente das mudanças de status, as mudanças de estágio são atualizações informativas somente para leitura que fornecem visibilidade da progressão do fluxo de trabalho de revisão interna sem exigir a ação do parceiro.

Destinatários

A conta proprietária receberá o evento para a alocação de benefícios.

Exemplo


{
  "id": "2mn33210-p5om-i53l-n747-7kk6241r585s",
  "detail-type": "Benefit Application Stage Changed",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-02-13T11:15:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-application/benappl-12345abcdef123"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitApplication": {
      "id": "benappl-12345abcdef123",
      "fulfillmentTypes": ["CREDITS"],
      "status": "IN_REVIEW",
      "stage": "FINANCIAL_REVIEW",
      "revision": "mm2j3955-j74g-96i9-f261-991100995567"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Alocação de benefícios ativada

Contexto de acionamento

O evento Benefit Allocation Activated é publicado na Amazon EventBridge quando uma alocação de benefícios passa para o status ATIVO por meio do Benefits Service. Esse evento ocorre quando um revisor interno atualiza o status da alocação por meio da UpdateBenefitAllocationInternal API para reativar uma alocação anteriormente inativa.

Esse evento geralmente ocorre quando uma alocação que foi temporariamente inativada (devido à expiração, mudanças na política ou motivos administrativos) é restaurada ao status de ativa, disponibilizando novamente os benefícios para utilização pelo parceiro.

Destinatários

A AWS conta pertencente ao parceiro receberá a mensagem. Em outras palavras, a AWS Conta que possui o recurso.

Evento de exemplo


{  
  "id": "3no44321-q6pn-j64m-o858-8ll7352s696t",
  "detail-type": "Benefit Allocation Activated",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-03-01T08:15:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitAllocation": {
      "id": "benalloc-abc123def456",
      "fulfillmentType": "CREDITS",
      "status": "ACTIVE"
    },
    "benefitApplication": {
      "id": "benappl-12345abcdef123"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Alocação de benefícios inativada

Contexto de acionamento

O evento de alocação de benefícios inativada é publicado na Amazon EventBridge quando uma alocação de benefícios passa para o status INATIVO por meio do Serviço de benefícios. Esse evento ocorre quando um revisor interno atualiza o status da alocação por meio da UpdateBenefitAllocationInternal API ou quando uma alocação de benefícios expira automaticamente.

Esse evento geralmente ocorre quando uma alocação é temporariamente suspensa (devido à expiração, mudanças na política, problemas de conformidade ou motivos administrativos), tornando os benefícios indisponíveis para utilização pelo parceiro até serem reativados.

Destinatários

A AWS conta pertencente ao parceiro receberá a mensagem. Em outras palavras, a AWS Conta que possui o recurso.

Evento de exemplo


{  
  "id": "4op55432-r7qo-k75n-p969-9mm8463t707u",
  "detail-type": "Benefit Allocation Inactivated",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-06-30T23:59:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitAllocation": {
      "id": "benalloc-abc123def456",
      "fulfillmentType": "CREDITS",
      "status": "INACTIVE"
    },
    "benefitApplication": {
      "id": "benappl-12345abcdef123"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Alocação de benefícios cumprida

Contexto de acionamento

O evento Benefit Allocation Fulfilled é publicado na Amazon EventBridge quando uma alocação de benefícios passa para o status FULFILLED por meio do Benefits Service. Esse evento ocorre quando um revisor interno atualiza o status da alocação por meio da UpdateBenefitAllocationInternal API para indicar que a alocação foi totalmente utilizada ou que os termos do benefício foram atendidos.

Esse evento representa a conclusão do ciclo de vida do benefício, indicando que o parceiro utilizou com sucesso o benefício alocado ou que a alocação chegou à sua conclusão natural.

Destinatários

A AWS conta pertencente ao parceiro receberá a mensagem. Em outras palavras, a AWS Conta que possui o recurso.

Evento de exemplo


{  
  "id": "5pq66543-s8rp-l86o-q070-0nn9574u818v",
  "detail-type": "Benefit Allocation Fulfilled",
  "source": "aws.partnercentral-benefits",
  "account": "123456789012",
  "time": "2025-12-15T17:30:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:partnercentral:us-east-1:123456789012:benefit-allocation/benalloc-abc123def456"
  ],
  "detail": {
    "catalog": "AWS",
    "benefitAllocation": {
      "id": "benalloc-abc123def456",
      "fulfillmentType": "CREDITS",
      "status": "FULFILLED"
    },
    "benefitApplication": {
      "id": "benappl-12345abcdef123"
    },
    "benefit": {
      "id": "ben-xyz789uvw012",
      "name": "AWS Partner Credits",
      "program": ["AWS Partner Network"]
    }
  }
}

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Notificações para o AWS API de vendas da Central de Parceiros

Notificações para o AWS API do Partner Central Channel