View a markdown version of this page

Logging AWS Marketplace Appels d'API d'accord avec CloudTrail - AWS Marketplace
Informations sur l'API des accords dans CloudTrailComprendre les actions de l'API AccordsComprendre les entrées du fichier journal de l'API des accords

La référence d'API AWS Marketplace a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez le manuel AWS Marketplace API Reference.

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.

Logging AWS Marketplace Appels d'API d'accord avec CloudTrail

L'API Agreements est intégrée à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un Service AWS utilisateur AWS Marketplace. CloudTrail capture les appels d'API pour l'API Agreements sous forme d'événements. Les appels capturés incluent des appels provenant du AWS Marketplace site Web, de la console et d'autres interfaces utilisant l'API Agreements, ainsi que des appels de code directs vers les opérations de l'API Agreements.

Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris des événements pour l'API Agreements. Un suivi permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans Historique des événements. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faite à l'API Agreements, l'adresse IP à partir de laquelle la demande a été faite, qui a fait la demande, quand elle a été faite et des informations supplémentaires.

Pour plus d'informations CloudTrail, consultez le guide de AWS CloudTrail l'utilisateur.

Informations sur l'API des accords dans CloudTrail

CloudTrail est activé sur votre compte Compte AWS lorsque vous créez le compte. Lorsqu'une activité se produit dans l'API Agreements, cette activité est enregistrée dans un CloudTrail événement avec d'autres Service AWS événements dans l'historique des événements. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre Compte AWS. Pour plus d'informations, consultez la section Affichage des événements avec l'historique des CloudTrail événements dans le Guide de AWS CloudTrail l'utilisateur.

Pour un enregistrement continu des événements de votre navigateur Compte AWS, y compris des événements relatifs à l'API Agreements, créez une trace. Un suivi permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un journal d’activité dans la console, il s’applique à toutes les régions Régions AWS. Le journal d’activité consigne les événements de toutes les régions dans la partition AWS et livre les fichiers journaux dans le compartiment Simple Storage Service (Amazon S3) de votre choix. En outre, vous pouvez en configurer d'autres Services AWS pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour plus d’informations, consultez les ressources suivantes :

Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants :

  • Si la demande a été effectuée avec les informations d’identification utilisateur racine ou .

  • Si la demande a été effectuée avec les informations d’identification de sécurité temporaires d’un rôle ou d’un utilisateur fédéré.

  • Si la requête a été effectuée par un autre Service AWS.

Pour plus d'informations, consultez l'élément CloudTrail UserIdentity dans le guide de l'AWS CloudTrail utilisateur.

Comprendre les actions de l'API Accords

L'API Agreements est utilisée pour acheter des logiciels en tant que service (SaaS), des serveurs (y compris des conteneurs) et des produits de services professionnels sur AWS Marketplace. Il est également utilisé pour gérer les accords ou les abonnements qui en résultent sur AWS Marketplace.

Note

Les achats de AWS Data Exchange produits ne seront pas enregistrés CloudTrail.

L'AcceptAgreementRequestaction est utilisée lorsqu'un utilisateur Gestion des identités et des accès AWS (IAM) ou un rôle d'un utilisateur Compte AWS achète un produit applicable sur AWS Marketplace. De même, l'CancelAgreementaction est utilisée lorsqu'un utilisateur ou un rôle IAM annule son accord ou son abonnement. En surveillant CloudTrail les journaux dans l'API Agreements, les acheteurs peuvent surveiller eux-mêmes Compte AWS les actions les plus importantes liées aux achats. AWS Marketplace

L'DescribeAgreementaction est utilisée lorsque le client consulte spécifiquement les métadonnées d'un accord spécifique. L'GetAgreementTermsaction est utilisée lorsque les termes d'un accord particulier sont consultés. L'SearchAgreementsaction est utilisée lorsqu'un utilisateur ou un rôle IAM répertorie ou filtre un sous-ensemble de ses accords dans la liste complète de tous ses accords.

Note

Les CancelAgreement actions AcceptAgreementRequest et sont accessibles aux acheteurs, mais pas aux vendeurs. Toutefois, les SearchAgreements actions DescribeAgreementGetAgreementTerms, et peuvent être utilisées à la fois par les acheteurs et les vendeurs.

Les acheteurs peuvent également identifier l'identifiant de l'accord dans le CloudTrail journal. Pour plus d'informations sur l'accord, choisissez l'onglet Gérer les abonnements dans la AWS Marketplace console, où l'ID de l'accord est fourni dans la vue Détails. L'ID d'accord se trouve dans responseElements l'action AcceptAgreementRequest API et dans requestParameters l'action CancelAgreement API.

Comprendre les entrées du fichier journal de l'API des accords

Un suivi est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics. Ils ne s'affichent donc pas dans un ordre spécifique.

L'exemple suivant montre une entrée de CloudTrail journal illustrant l'AcceptAgreementRequestaction.

{
  "eventVersion": "1.08",
  "userIdentity": {
    "type": "Unknown",
    "principalId": "ABCDEFGHIJKLMNOP12345",
    "arn": "arn:aws:iam::123456789010:user/CloudTrailTestUser",
    "accountId": "123456789010",
    "accessKeyId": "ABCDEFGHIJKLMNOP123"
  },
  "eventTime": "2023-08-11T17:13:50Z",
  "eventSource": "agreement-marketplace.amazonaws.com",
  "eventName": "AcceptAgreementRequest",
  "awsRegion": "us-west-2",
  "sourceIPAddress": "127.0.0.1",
  "userAgent": "Coral/Netty4",
  "requestParameters": {
    "agreementRequestId": "ar-6xbrddjzym594imkrrezrn5wa"
  },
  "responseElements": {
    "agreementId": "agmt-1lnrq6riwpg2tczhv378zknlc"
  },
  "requestID": "fEXAMPLE-cb3e-4e21-86fd-6b3EXAMPLEd1",
  "eventID": "7EXAMPLE-97d6-4139-91e3-01aEXAMPLE48",
  "readOnly": false,
  "eventType": "AwsApiCall",
  "managementEvent": true,
  "recipientAccountId": "123456789010",
  "eventCategory": "Management"
}

L'exemple suivant montre une entrée de CloudTrail journal illustrant l'CancelAgreementaction.

{
  "eventVersion": "1.08",
  "userIdentity": {
    "type": "Unknown",
    "principalId": "ABCDEFGHIJKLMNOP12345",
    "arn": "arn:aws:iam::123456789010:user/CloudTrailTestUser",
    "accountId": "123456789010",
    "accessKeyId": "ABCDEFGHIJKLMNOP1234"
  },
  "eventTime": "2023-08-14T03:11:42Z",
  "eventSource": "agreement-marketplace.amazonaws.com",
  "eventName": "CancelAgreement",
  "awsRegion": "us-west-2",
  "sourceIPAddress": "127.0.0.1",
  "userAgent": "Coral/Netty4",
  "requestParameters": {
    "agreementId": "agmt-enitbfqjebjmwmomzrucf032t"
  },
  "responseElements": null,
  "requestID": "fEXAMPLE-cb3e-4e21-86fd-6b3EXAMPLEd1",
  "eventID": "7EXAMPLE-97d6-4139-91e3-01aEXAMPLE48",
  "readOnly": false,
  "eventType": "AwsApiCall",
  "managementEvent": true,
  "recipientAccountId": "123456789010",
  "eventCategory": "Management"
}

L'exemple suivant montre une entrée de CloudTrail journal illustrant l'DescribeAgreementaction.

{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "Unknown",
        "principalId": "ABCDEFGHIJKLMNOP12345",
        "arn": "arn:aws:iam::123456789010:user/CloudtrailTestUser",
        "accountId": "123456789010",
        "accessKeyId": "ABCDEFGHIJKLMNOP123",
    },
    "eventTime": "2023-10-30T22:45:24Z",
    "eventSource": "agreement-marketplace.amazonaws.com",
    "eventName": "DescribeAgreement",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "127.0.0.1",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36",
    "requestParameters": {
        "agreementId": "agmt-6wy4rhp7l6iyuu2jrcgd1shdi"
    },
    "responseElements": null,
    "requestID": "bEXAMPLE-347f-4c07-9645-cd2EXAMPLE61",
    "eventID": "dEXAMPLE-d891-42a5-8da6-1cdEXAMPLE34",
    "readOnly": true,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "123456789010",
    "eventCategory": "Management",
}

L'exemple suivant montre une entrée de CloudTrail journal illustrant l'GetAgreementTermsaction.

{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "Unknown",
        "principalId": "ABCDEFGHIJKLMNOP12345",
        "arn": "arn:aws:iam::123456789010:user/CloudtrailTestUser",
        "accountId": "123456789010",
        "accessKeyId": "ABCDEFGHIJKLMNOP123",
    },
    "eventTime": "2023-10-30T22:48:37Z",
    "eventSource": "agreement-marketplace.amazonaws.com",
    "eventName": "GetAgreementTerms",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "127.0.0.1",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36",
    "requestParameters": {
        "agreementId": "agmt-6wy4rhp7l6iyuu2jrcgd1shdi"
    },
    "responseElements": null,
    "requestID": "eEXAMPLE-fc57-4127-bbda-bc1EXAMPLE03",
    "eventID": "bEXAMPLE-5345-4634-8b58-925EXAMPLE3e",
    "readOnly": true,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "123456789010",
    "eventCategory": "Management",
}

L'exemple suivant montre une entrée de CloudTrail journal illustrant l'SearchAgreementsaction.

{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "Unknown",
        "principalId": "ABCDEFGHIJKLMNOP12345",
        "arn": "arn:aws:iam::123456789010:user/CloudtrailTestUser",
        "accountId": "123456789010",
        "accessKeyId": "ABCDEFGHIJKLMNOP123",
    },
    "eventTime": "2023-10-30T18:41:10Z",
    "eventSource": "agreement-marketplace.amazonaws.com",
    "eventName": "SearchAgreements",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "127.0.0.1",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36",
    "requestParameters": {
        "catalog": "AWSMarketplace",
        "filters": [
            {
                "name": "PartyType",
                "values": [
                    "Proposer"
                ]
            },
            {
                "name": "ResourceType",
                "values": [
                    "SaaSProduct"
                ]
            },
            {
                "name": "Status",
                "values": [
                    "ACTIVE"
                ]
            },
            {
                "name": "AgreementType",
                "values": [
                    "PurchaseAgreement"
                ]
            }
        ],
        "maxResults": 5
    },
    "responseElements": null,
    "requestID": "fEXAMPLE-0aa6-4e42-8715-6a1EXAMPLE95",
    "eventID": "0EXAMPLE-8ce8-4814-bcf1-636EXAMPLEb5",
    "readOnly": true,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "123456789010",
    "eventCategory": "Management",
}