EventBridge Événements Amazon - AWS Marketplace
Événements pour de nouvelles offresÉvénements pour les ensembles de modificationsRapport de synthèse sur les événements liés à la sécuritéÉvénements relatifs aux décaissements

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

EventBridge Événements Amazon

En tant que vendeur, vous pouvez utiliser Amazon EventBridge pour recevoir des notifications concernant des événements survenus dans AWS Marketplace. Par exemple, vous pouvez recevoir un événement AWS Marketplace dès la création d'une offre. L'événement contient des informations telles que l'identifiant, la date d'expiration et les détails du produit. EventBridge est un service de bus d'événements que vous pouvez utiliser pour connecter vos applications à des données provenant de diverses sources. Pour plus d'informations, consultez le guide de EventBridge l'utilisateur Amazon. Les sections suivantes fournissent des informations détaillées sur les événements survenus dans le cadre du service Marketplace Catalog dans la EventBridge console.

Cette rubrique

Action du vendeur Événement reçu Rubrique connexe
Un fournisseur de logiciels indépendant (ISV) crée une offre et la rend disponible à l'achat Offer Released Événements pour de nouvelles offres
Le produit d'ISV est utilisé par un partenaire de distribution pour créer une offre Offer Released Événements pour de nouvelles offres
Le partenaire de distribution crée une offre Offer Released Événements pour de nouvelles offres
L'ensemble de modifications réussit Change Set Succeeded Événements pour les ensembles de modifications
L'ensemble de modifications échoue Change Set Failed Événements pour les ensembles de modifications
L'ensemble de modifications est annulé Change Set Cancelled Événements pour les ensembles de modifications
Des failles de sécurité ont été détectées sur le produit de l'ISV Products Security Report Created Rapport de synthèse sur les événements liés à la sécurité

Événements pour de nouvelles offres

Lorsque les vendeurs créent une offre et la mettent en vente, ils peuvent recevoir un événement avec le type de détail suivant :Offer Released.

Note

Pour plus d'informations sur la création de EventBridge règles, consultez EventBridge les règles Amazon dans le guide de EventBridge l'utilisateur Amazon.

Voici un exemple de corps d'événement pour une nouvelle offre créée par un éditeur de logiciels indépendants.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:123456789012:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "123456789012",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": [
      "999988887777",
      "111122223333"
    ]
  }
}

Voici un exemple de corps d'événement lorsque le produit d'un ISV est utilisé par un partenaire de distribution pour créer une offre.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "987654321098",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": ["999988887777", "111122223333"],
    }
  }
}

Voici un exemple de corps d'événement lorsqu'un partenaire de distribution crée une offre.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "987654321098",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "987654321098",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": ["999988887777", "111122223333"],
    }
  }
}

Événements pour les ensembles de modifications

Lorsqu'un ensemble de modifications est terminé, les vendeurs, les partenaires de distribution et les administrateurs du marché privé peuvent bénéficier d'un événement. L'API du AWS Marketplace catalogue envoie un événement lorsqu'un ensemble de modifications se termine avec le statut « réussi », « échec » ou « annulé ». La source de ces événements estaws.marketplacecatalog, et les valeurs de type de détail possibles sont Change Set SucceededChange Set Failed, etChange Set Cancelled.

Note

Pour plus d'informations sur les ensembles de modifications, consultez la section Utilisation des ensembles de modifications dans le manuel AWS Marketplace Catalog API Reference.

Chaque événement contient les détails de la demande de modification, tels que l'ID du jeu de modifications, le nom du jeu de modifications, le type de détail de l'événement, le code d'échec (pour les demandes ayant échoué) et les heures de début et de fin de la demande. Cela vous permet de surveiller vos ensembles de modifications sans demander en permanence l'DescribeChangeSetaction ou vérifier l' Portail de gestion AWS Marketplace état de vos demandes de modification.

Note

Pour plus d'informations sur la création de EventBridge règles, consultez EventBridge les règles Amazon dans le guide de EventBridge l'utilisateur Amazon.

Voici un exemple de corps d'événement pour le type de Change Set Succeeded détail.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Succeeded",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z"
  }
}

Voici un exemple de corps d'événement pour le type de Change Set Failed détail.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Failed",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z",
    "FailureCode": "CLIENT_ERROR"
  }
}

Voici un exemple de corps d'événement pour le type de Change Set Cancelled détail.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Cancelled",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z"
  }
}

Rapport de synthèse sur les événements liés à la sécurité

Lorsque des failles de sécurité sont détectées sur les produits d'un vendeur, celui-ci peut recevoir un rapport récapitulatif et des rappels périodiques concernant les problèmes liés aux produits en suspens. La source de ces événements estaws.marketplacecatalog, et le type de détail estProducts Security Report Created.

Chaque événement inclut un résumé du nombre de produits et de versions présentant des problèmes détectés, le nombre de dernières versions concernées et la date à laquelle une résolution est requise pour empêcher une restriction temporaire de ces produits ou versions.

Note

Pour plus d'informations sur la création de EventBridge règles, consultez EventBridge les règles Amazon dans le guide de EventBridge l'utilisateur Amazon.

Pour plus de détails sur la gestion des événements de sécurité, consultez le billet de AWS Marketplace blog Comment améliorer la sécurité de votre catalogue de produits sur le AWS blog.

Voici un exemple de corps d'événement pour le type de Products Security Report Created détail.

{
  "version": "0",
   "id": "01234567-0123-0123-0123-0123456789ab",
   "detail-type": "Products Security Report Created",
   "source": "aws.marketplacecatalog",
   "account": "123456789012",
   "time": "2023-10-31T00:00:00Z",
   "region": "us-east-1",
   "resources": [],
   "detail": {
     "numberOfProductsWithIssues": 1,
     "numberOfVersionsWithIssues": 1,
     "numberOfLatestVersionsWithIssues": 1,
     "newIssuesFound": true,
     "upcomingResolutionDueDate": "2023-12-01T00:00:00Z",
     "requestId": "533fa17d-3e97-5051-bcaf-1fae45fb3f8b"
   }
  }

Événements relatifs aux décaissements

Lorsqu'un versement sur le compte bancaire d'un vendeur échoue en raison d'informations bancaires non valides, AWS Marketplace ISVs les partenaires de distribution peuvent bénéficier d'un événement.

Dans le code d'événement JSON suivant, la source valeur de ces événements estaws.marketplace, et la detail-type valeur estDisbursement Paused. La resources valeur indique le numéro de ressource Amazon (ARN) du compte bancaire non valide.

{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab", 
"detail-type": "Disbursement Paused",
"source": "aws.marketplace",
"account":"<account id of end user>",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": ["arn:aws:payments:us-east-1:1234567890:paymentinstrument:123"],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace"
 }
}

Pour résoudre le problème d'informations bancaires non valides, ajoutez les informations de votre compte bancaire dans le portail AWS Marketplace de gestion. Pour obtenir des instructions, consultez Pour ajouter des informations de compte bancaire.

Pour plus d'informations sur la création de EventBridge règles Amazon, consultez la section Règles d'Amazon EventBridge dans le guide de EventBridge l'utilisateur Amazon.