A referência da API do AWS Marketplace foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência de API do AWS Marketplace.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Registro em log AWS Marketplace Chamadas de API de contrato com CloudTrail
A API de Acordos é integrada com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, função ou AWS service (Serviço da AWS) membro AWS Marketplace. CloudTrail captura chamadas de API para a API de Acordos como eventos. As chamadas capturadas incluem chamadas do AWS Marketplace site, do console e de outras interfaces que utilizam a API de Acordos, bem como chamadas diretas de código para as operações da API de Acordos.
Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para a API Agreements. Uma trilha permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no Histórico de eventos. Usando as informações coletadas por CloudTrail, você pode determinar a solicitação que foi feita à API de Acordos, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.
Para obter mais informações sobre CloudTrail, consulte o Guia AWS CloudTrail do usuário.
Informações da API de contratos em CloudTrail
CloudTrail é ativado no seu Conta da AWS quando você cria a conta. Quando a atividade ocorre na API de Acordos, essa atividade é registrada em um CloudTrail evento junto com outros AWS service (Serviço da AWS) eventos no histórico de eventos. Você pode visualizar, pesquisar e baixar eventos recentes no seu Conta da AWS. Para obter mais informações, consulte Visualização de CloudTrail eventos com histórico de eventos no Guia AWS CloudTrail do usuário.
Para um registro contínuo dos eventos em seu Conta da AWS, incluindo eventos da API de Acordos, crie uma trilha. Uma trilha permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as Regiões da AWS. A trilha registra eventos de todas as regiões na partição da AWS e entrega os arquivos de log no bucket do Amazon S3 que você especifica. Além disso, você pode configurar outros Serviços da AWS para analisar e agir com base nos dados do evento coletados nos CloudTrail registros. Para saber mais, consulte:
Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar o seguinte:
-
Se a solicitação foi feita com credenciais de usuário da raiz ou do .
-
Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado.
-
Se a solicitação foi feita por outro AWS service (Serviço da AWS).
Para obter mais informações, consulte o elemento CloudTrail userIdentity no Guia do AWS CloudTrail usuário.
Entendendo as ações da API de acordos
A API de Acordos é usada para comprar produtos de software como serviço (SaaS), servidor (incluindo contêiner) e serviços profissionais em. AWS Marketplace Também é usado para gerenciar contratos ou assinaturas resultantes em. AWS Marketplace
nota
As compras de AWS Data Exchange produtos não serão registradas por CloudTrail.
A AcceptAgreementRequest ação é usada quando um usuário AWS Identity and Access Management (IAM) ou uma função de um Conta da AWS compra um produto aplicável em AWS Marketplace. Da mesma forma, a CancelAgreement ação é usada quando um usuário ou função do IAM cancela seu contrato ou assinatura. Ao monitorar CloudTrail os registros na API de Acordos, os compradores podem monitorar as ações mais importantes relacionadas à compra que acontecem sozinhos. Conta da AWS AWS Marketplace
A DescribeAgreement ação é usada quando o cliente visualiza especificamente os metadados de um contrato específico. A GetAgreementTerms ação é usada quando os termos de um contrato específico são visualizados. A SearchAgreements ação é usada quando um usuário ou função do IAM lista ou filtra um subconjunto de seus contratos da lista completa de todos os contratos.
nota
As CancelAgreement ações AcceptAgreementRequest e estão disponíveis para compradores, mas não para vendedores. No entantoDescribeAgreement, as SearchAgreements açõesGetAgreementTerms, e podem ser usadas tanto por compradores quanto por vendedores.
Os compradores também podem identificar a ID do contrato no CloudTrail registro. Para obter mais informações sobre o contrato, escolha a guia Gerenciar assinaturas no AWS Marketplace console, onde a ID do contrato é fornecida na visualização Detalhes. O ID do contrato pode ser encontrado na responseElements ação da AcceptAgreementRequest API e na requestParameters ação da CancelAgreement API.
Compreendendo as entradas do arquivo de log da API Agreements
Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3 que você especificar. CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros da solicitação e assim por diante. CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das chamadas públicas de API, portanto, eles não são exibidos em uma ordem específica.
O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a AcceptAgreementRequest ação.
{ "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" }
O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a CancelAgreement ação.
{ "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" }
O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a DescribeAgreement ação.
{ "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", }
O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a GetAgreementTerms ação.
{ "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", }
O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a SearchAgreements ação.
{ "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", }
