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. # Uso de AWS Marketplace API de acuerdo AWS Marketplace es un catálogo digital seleccionado que los clientes pueden usar para buscar, comprar, implementar y administrar software, datos y servicios de terceros para crear soluciones y administrar sus negocios. El servicio de AWS Marketplace acuerdos proporciona una interfaz API que ayuda a AWS Marketplace los compradores y vendedores a gestionar sus acuerdos, incluidos los acuerdos de venta, búsqueda y filtrado. ## Conceptos clave En la siguiente tabla se describen los conceptos clave que se utilizan en la API de AWS Marketplace acuerdos. | Concepto | Description (Descripción) | | --- | --- | | Aceptador | La parte que acepta todos o un subconjunto de los términos extendidos por el proponente en un acuerdo. En los casos de uso más comunes, los aceptadores son los compradores del producto. | | Acuerdo | Documento que vincula a dos partes, entre ellas el proponente (habitualmente, el seller/ISV socio del canal) y el aceptante (habitualmente, el comprador), y en el que se definen los términos y condiciones aplicables entre ambas partes. | | Solicitud de cancelación del acuerdo | Solicitud iniciada por el vendedor (proponente) para cancelar un acuerdo activo. El comprador (aceptante) puede aceptar o rechazar la solicitud de cancelación. Si se acepta, el flujo de trabajo de cancelación del acuerdo se ejecuta de forma asíncrona y el estado del acuerdo cambia a cancelado. Si se rechaza, el acuerdo permanece activo y el vendedor puede enviar una nueva solicitud de cancelación. | | Propuesta de acuerdo | Entidad que hace referencia al conjunto de terms/offer propuestas por la seller/proposer. | | Solicitud de acuerdo | Entidad que hace referencia al recurso creado como resultado de la acción del cliente y describe creation/modification los parámetros del acuerdo, el ciclo de vida de la solicitud y el resultado estimado tras la aceptación de la solicitud. | | Dimensión facturable | Elementos relacionados con el precio del producto. Por ejemplo, instancias de Amazon Elastic Compute Cloud (Amazon EC2) para productos de Amazon Machine Image (AMI) o premium en comparación con usuarios de solo lectura para productos de software como servicio (SaaS). | | Socios de canal (CP) | Organizaciones que están autorizadas por el propietario del producto (ISV) para revender sus productos en su nombre en. AWS Marketplace | | Proveedores de software independientes (ISV) | Vendedores que publican y administran sus propios productos en AWS Marketplace. | | Intención | La intención representa la motivación que tiene el comprador al crear el Acuerdo. Las intenciones admitidas actualmente son las siguientes: Nueva, Modificación y Reemplazo durante el proceso de creación del acuerdo. | | Solicitud de pago | Solicitud de pago iniciada por el vendedor (proponente) asociada a un acuerdo. El comprador (aceptante) puede aceptar o rechazar la solicitud de pago. | | Proponente | La parte que amplía el conjunto inicial de condiciones de un acuerdo, por lo general mediante una oferta. | | Órdenes de compra | Las organizaciones exigen que los compradores utilicen las órdenes de compra para comprar a proveedores aprobados, hagan un seguimiento de lo que compran y se aseguren de que los gastos se pronostican, presupuestan, aprueban y asignan a los centros de costos responsables. | | Recurso | Unidad o recurso en el que los vendedores pretenden vender AWS Marketplace, lo que suele denominarse producto base. Un producto base no está completo para que lo consuma el comprador hasta que se añada la información del producto, los atributos de despliegue y la información de facturación. Un producto describe la información del producto, los atributos de implementación del software y el mecanismo de facturación del anuncio que el vendedor pretende vender. El producto debe ir acompañado de una oferta para convertirse en una unidad negociable que pueda ser vendida y utilizada por los compradores. AWS Marketplace | | Plazo | Unidad incluida en un acuerdo que regula la forma en que se hace cumplir un acuerdo (por ejemplo, los precios). | ## Punto de conexión Puede acceder al servicio de AWS Marketplace contratos con los siguientes puntos de conexión: | Punto de conexión | Region | Protocolos IP compatibles | | --- | --- | --- | | agreement-marketplace.us-east-1.api.aws | Este de EE. UU. (Norte de Virginia) | IPv4, IPv6 | ## Permisos La API de acuerdos utiliza la autenticación estándar de la versión 4 (SiGv4) de AWS firma. Debe tener AWS credenciales válidas y los permisos de IAM adecuados para poder llamar a la API. Para obtener más información, consulte [Control de acceso para AWS Marketplace API de acuerdo](agreement-api-access-control.md). ### Códigos de error Los siguientes códigos de error se aplican a las [acciones de AWS Marketplace Agreement Service](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Operations_AWS_Marketplace_Agreement_Service.html). Es posible que se devuelva un único código de error para varios casos de uso. Consulte las descripciones siguientes para identificar el escenario específico en el que se produce cada código de error. Esta lista no es exhaustiva y puede actualizarse a medida que se publiquen nuevas funciones. #### ValidationException | Código de error | Description (Descripción) | | --- | --- | | INVALID\_SOURCE\_AGREEMENT\_IDENTIFIER | Se devuelve cuando el identificador del acuerdo de origen no coincide con el formato esperado o cuando se proporciona un identificador de acuerdo de origen para fines que no lo requieren (por ejemplo, NUEVO). | | MISSING\_SOURCE\_AGREEMENT\_IDENTIFIER | Se devuelve cuando no se proporciona el identificador del acuerdo de origen para una intención que lo requiere (como REPLACE o AMEND). | | INVALID\_REQUESTED\_TERM\_CONFIGURATION | Se devuelve cuando la configuración del término solicitada no es válida. Posibles escenarios:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | | INVALID\_AGREEMENT\_PROPOSAL\_IDENTIFIER | Se devuelve cuando el identificador de la propuesta de acuerdo no coincide con el formato esperado o cuando se proporciona un identificador de la propuesta de acuerdo para fines que no lo requieren (como AMEND). | | MISSING\_AGREEMENT\_PROPOSAL\_IDENTIFIER | Se devuelve cuando no se proporciona el identificador de la propuesta de acuerdo para una intención que lo requiere (como NEW o REPLACE). | | INVALID\_FILTER\_NAME | Se devuelve cuando el nombre del filtro proporcionado no es un filtro reconocido o cuando se incluyen nombres de filtro duplicados en la solicitud. | | INVALID\_FILTER\_VALUES | Se devuelve cuando los valores del filtro no son válidos, están duplicados, están vacíos, superan el recuento máximo permitido o cuando un filtro de intervalo de fechas especifica un BeforeEndTime valor que precede al AfterEndTime valor. | | INVALID\_NEXT\_TOKEN | Se devuelve cuando el token de paginación tiene un formato incorrecto, ha caducado, no se puede descifrar o cuando los parámetros de la solicitud han cambiado entre las llamadas paginadas. | | DUPLICATE\_CHARGES | Se devuelve cuando la solicitud contiene identificadores de cargo duplicados o cuando se proporcionan valores de pedido de compra diferentes para el mismo identificador de cargo. | | UNSUPPORTED\_FILTERS | Se devuelve cuando no se admite la combinación de filtros proporcionada. Las combinaciones de filtros admitidas varían en función del tipo de grupo. Consulta las combinaciones compatibles en la documentación pública. | | INVALID\_PURCHASE\_ORDER\_REFERENCE | Se devuelve cuando la referencia del pedido de compra no cumple con los requisitos de formato o cuando no se proporciona el pedido de compra obligatorio tal como lo configuró el administrador de la cuenta. | | INVALID\_CHARGE\_AMOUNT | Se devuelve cuando el importe del cargo no es válido. Posibles escenarios:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | | UNSUPPORTED\_ACTION | Se devuelve cuando la operación solicitada no es compatible con el estado actual del recurso. Los escenarios específicos varían según la API:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | #### ResourceNotFoundException Las `ResourceNotFoundException` inclusiones `resourceType` y `resourceId` los campos que identifican el recurso que no se pudo encontrar. En la siguiente tabla se describen los escenarios que pueden provocar esta excepción para cada tipo de recurso. **nota** Por motivos de seguridad, se devuelve el mismo error tanto si un recurso no existe como si la persona que llama no tiene acceso a él. Esto impide la enumeración de identificadores de recursos válidos. | Tipo de recurso | Posibles escenarios | | --- | --- | | AgreementProposal | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | | Agreement | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | | AgreementRequest | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | | Charge | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | | BillingAdjustmentRequest | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | | AgreementCancellationRequest | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) | | PaymentRequest | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/marketplace/latest/developerguide/agreement-apis.html) |