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](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
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](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).
## 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](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) 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:
+ [Introducción a la creación de registros de seguimiento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail servicios e integraciones compatibles](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [Configuración de notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Recepción de archivos de CloudTrail registro de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) y [recepción de archivos de CloudTrail registro de varias cuentas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
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.](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)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",
}
```