Se reestructuró la referencia de API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia de API de AWS Marketplace.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Registro AWS Marketplace Acuerdos: llamadas a la API con CloudTrail
La API de Acuerdos está integrada con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o una Servicio de AWS persona AWS Marketplace. CloudTrail captura las llamadas a la API de Acuerdos como eventos. Las llamadas capturadas incluyen llamadas desde el AWS Marketplace sitio web, la consola y otras interfaces que utilizan la API de Acuerdos, así como llamadas de código directas a las operaciones de la API de Acuerdos.
Si crea una ruta, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos de la API de Acuerdos. Un rastro permite CloudTrail entregar archivos de registro a un bucket de Amazon S3. Si no configura una ruta, podrá ver los eventos más recientes en la CloudTrail consola, en el historial de eventos. Con la información recopilada por CloudTrail, puedes determinar la solicitud que se realizó a la API de Acuerdos, la dirección IP desde la que se realizó la solicitud, quién la hizo, cuándo se realizó y detalles adicionales.
Para obtener más información al respecto CloudTrail, consulte la Guía AWS CloudTrail del usuario.
Información sobre la API de acuerdos en CloudTrail
CloudTrail está habilitada en tu cuenta Cuenta de AWS al crear la cuenta. Cuando se produce una actividad en la API de acuerdos, esa actividad se registra en un CloudTrail evento junto con otros Servicio de AWS eventos en el historial de eventos. Puede ver, buscar y descargar los eventos recientes en su Cuenta de AWS. Para obtener más información, consulte Visualización de eventos con el historial de CloudTrail eventos en la Guía del AWS CloudTrail usuario.
Para obtener un registro continuo de los eventos en su Cuenta de AWS entorno, incluidos los eventos de la API de acuerdos, cree un registro. Un rastro permite CloudTrail entregar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las Regiones de AWS. El registro de seguimiento registra los eventos de todas las regiones de la partición de AWS y envía los archivos de registro al bucket de Amazon S3 especificado. Además, puede configurar otros Servicios de AWS para analizar más a fondo los datos de eventos recopilados en los CloudTrail registros y actuar en función de ellos. Para más información, consulte los siguientes temas:
Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario le ayuda a determinar lo siguiente:
-
Si la solicitud se realizó con las credenciales raíz o del usuario.
-
Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.
-
Si la solicitud la realizó otro Servicio de AWS.
Para obtener más información, consulte el elemento CloudTrail UserIdentity en la Guía del usuario.AWS CloudTrail
Descripción de los acuerdos y acciones de la API
La API de Acuerdos se utiliza para comprar productos de software como servicio (SaaS), servidor (incluido contenedor) y servicios profesionales. AWS Marketplace También se utiliza para gestionar los acuerdos o suscripciones resultantes. AWS Marketplace
nota
Las compras de AWS Data Exchange productos no se registrarán en CloudTrail.
La AcceptAgreementRequest acción se utiliza cuando un usuario AWS Identity and Access Management (de IAM) o un rol de un usuario (IAM) Cuenta de AWS compra un producto aplicable. AWS Marketplace Del mismo modo, la CancelAgreement acción se utiliza cuando un usuario o rol de IAM cancela su acuerdo o suscripción. Al supervisar CloudTrail los registros de la API de acuerdos, los compradores pueden supervisar por sí mismos las acciones más importantes relacionadas con las compras que se están llevando a cabo. Cuenta de AWS AWS Marketplace
La DescribeAgreement acción se utiliza cuando el cliente consulta específicamente los metadatos de un acuerdo específico. La GetAgreementTerms acción se utiliza cuando se consultan los términos de un acuerdo concreto. La SearchAgreements acción se utiliza cuando un usuario o rol de IAM enumera o filtra un subconjunto de sus acuerdos de la lista completa de todos sus acuerdos.
nota
Las CancelAgreement acciones AcceptAgreementRequest y están disponibles para los compradores, pero no para los vendedores. Sin embargo, tanto los DescribeAgreement compradores como los vendedores pueden utilizar SearchAgreements las acciones, y. GetAgreementTerms
Los compradores también pueden identificar el identificador del acuerdo en el CloudTrail registro. Para obtener más información sobre el acuerdo, selecciona la pestaña Administrar suscripciones de la AWS Marketplace consola, donde se proporciona el ID del acuerdo en la vista de detalles. El ID del acuerdo se encuentra en responseElements la acción de AcceptAgreementRequest API y en requestParameters la acción de CancelAgreement API.
Descripción de las entradas del archivo de registro de la API de acuerdos
Un rastro es una configuración que permite la entrega de eventos como archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una solicitud única de cualquier fuente e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc. CloudTrail Los archivos de registro no son un seguimiento ordenado de las llamadas a la API pública, por lo que no se muestran en un orden específico.
En el siguiente ejemplo, se muestra una entrada de CloudTrail registro que demuestra la AcceptAgreementRequest acción.
{ "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" }
El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la CancelAgreement acción.
{ "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" }
El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la DescribeAgreement acción.
{ "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", }
El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la GetAgreementTerms acción.
{ "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", }
El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la SearchAgreements acción.
{ "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", }
