View a markdown version of this page

Protokollierung AWS Marketplace API-Aufrufe für Vereinbarungen mit CloudTrail - AWS Marketplace
API-Informationen zu Vereinbarungen finden Sie in CloudTrailGrundlegendes zu den API-Aktionen von VereinbarungenGrundlegendes zu den Einträgen der API-Protokolldatei für Vereinbarungen

Die AWS Marketplace API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Marketplace API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Protokollierung AWS Marketplace API-Aufrufe für Vereinbarungen mit CloudTrail

Die Agreements API ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der von einem Benutzer, einer Rolle oder einem AWS-Service Mitglied ausgeführten Aktionen bereitstellt AWS Marketplace. CloudTrail erfasst API-Aufrufe für die Agreements API als Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der AWS Marketplace Website, der Konsole und anderen Schnittstellen, die die Agreements API nutzen, sowie direkte Code-Aufrufe für Agreements API-Operationen.

Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Übermittlung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für die Agreements API. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im Ereignisverlauf einsehen. Anhand der von gesammelten Informationen können Sie die Anfrage CloudTrail, die an die Agreements API gestellt wurde, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details ermitteln.

Weitere Informationen dazu CloudTrail finden Sie im AWS CloudTrail Benutzerhandbuch.

API-Informationen zu Vereinbarungen finden Sie in CloudTrail

CloudTrail ist auf Ihrem aktiviert AWS-Konto , wenn Sie das Konto erstellen. Wenn Aktivitäten in der Agreements API auftreten, wird diese Aktivität zusammen mit anderen AWS-Service Ereignissen im CloudTrail Event-Verlauf in einem Ereignis aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem anzeigen, suchen und herunterladen AWS-Konto. Weitere Informationen finden Sie im AWS CloudTrail Benutzerhandbuch unter Ereignisse mit CloudTrail Ereignisverlauf anzeigen.

Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem System AWS-Konto, einschließlich der Ereignisse für die Agreements API, erstellen Sie einen Trail. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle AWS-Regionen-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen in der AWS -Partition und stellt die Protokolldateien in dem von Ihnen angegebenen Amazon-S3-Bucket bereit. Darüber hinaus können Sie andere konfigurieren, AWS-Services um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier:

Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte:

  • Ob die Anforderung mit Root- oder -Benutzeranmeldeinformationen ausgeführt wurde.

  • Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.

  • Ob die Anforderung aus einem anderen AWS-Service gesendet wurde.

Weitere Informationen finden Sie unter CloudTrail UserIdentity-Element im AWS CloudTrail Benutzerhandbuch.

Grundlegendes zu den API-Aktionen von Vereinbarungen

Die Agreements API wird verwendet, um Software-as-a-Service (SaaS), Server- (einschließlich Container) und Professional Services-Produkte zu erwerben AWS Marketplace. Sie wird auch verwendet, um daraus resultierende Verträge oder Abonnements für zu verwalten AWS Marketplace.

Anmerkung

Käufe von AWS Data Exchange Produkten werden nicht protokolliert CloudTrail.

Die AcceptAgreementRequest Aktion wird verwendet, wenn ein AWS Identity and Access Management (IAM-) Benutzer oder die Rolle eines Benutzers ein entsprechendes Produkt AWS-Konto kauft. AWS Marketplace In ähnlicher Weise wird die CancelAgreement Aktion verwendet, wenn ein IAM-Benutzer oder eine IAM-Rolle ihre Vereinbarung oder ihr Abonnement kündigt. Durch die Überwachung der CloudTrail Protokolle in der Agreements API können Käufer die wichtigsten kaufbezogenen Aktionen überwachen, die sie selbst ausführen. AWS-Konto AWS Marketplace

Die DescribeAgreement Aktion wird verwendet, wenn der Kunde gezielt Metadaten für eine bestimmte Vereinbarung aufruft. Die GetAgreementTerms Aktion wird verwendet, wenn die Bedingungen einer bestimmten Vereinbarung eingesehen werden. Die SearchAgreements Aktion wird verwendet, wenn ein IAM-Benutzer oder eine IAM-Rolle eine Teilmenge seiner Vereinbarungen auflistet oder aus der vollständigen Liste aller seiner Vereinbarungen herausfiltert.

Anmerkung

Die CancelAgreement Aktionen AcceptAgreementRequest und stehen Käufern, aber nicht Verkäufern zur Verfügung. Die SearchAgreements Aktionen DescribeAgreementGetAgreementTerms, und können jedoch sowohl von Käufern als auch von Verkäufern verwendet werden.

Käufer können die Vertrags-ID der Vereinbarung auch anhand des CloudTrail Protokolls identifizieren. Weitere Informationen zur Vereinbarung finden Sie auf der Registerkarte Abonnements verwalten in der AWS Marketplace Konsole. Dort finden Sie die Vertrags-ID in der Detailansicht. Die Vereinbarungs-ID finden Sie unter responseElements für die AcceptAgreementRequest API-Aktion und unter requestParameters für die CancelAgreement API-Aktion.

Grundlegendes zu den Einträgen der API-Protokolldatei für Vereinbarungen

Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden.

Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die AcceptAgreementRequest Aktion demonstriert.

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

Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die CancelAgreement Aktion demonstriert.

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

Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die DescribeAgreement Aktion demonstriert.

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

Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die GetAgreementTerms Aktion demonstriert.

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

Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die SearchAgreements Aktion demonstriert.

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