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.

Trabaje con las ofertas privadas de los socios de canal mediante el AWS Marketplace API

Puedes utilizarlas AWS Marketplace Catalog API para automatizar tareas y trabajar con ofertas privadas de socios de canal (CPPO).

Al crear o actualizar una CPPO, el borrador de la oferta incluirá los términos y normas de una autorización de reventa y el comprador no podrá verlo. Es posible, pero no obligatorio, involucrar a varias personas de tu organización para crear una oferta privada.

Por ejemplo, una persona puede ser responsable de actualizar los precios, mientras que una segunda persona puede ser responsable de actualizar el calendario de pagos. Luego, una tercera persona puede ser responsable de actualizar los términos legales. Puedes dar permiso a una persona para que actualice determinadas partes de una oferta. Sin embargo, solo puedes conceder permisos de lectura a las autorizaciones de reventa.

Como requisito previo para realizar cambios en los tipos de llamadas, debe haber recibido una o más autorizaciones de reventa y estar familiarizado con ellas. AWS Marketplace Catalog API

Para obtener más información, consulta las ofertas privadas de los socios del canal en la Guía del AWS Marketplace vendedor.

En los siguientes temas se describe cómo utilizar la API del catálogo para crear y actualizar las CPPO:

Requisitos previos de la CPPO

Service-linked el rol de configuración ResaleAuthorization (SLR) es un requisito previo obligatorio para utilizar la autorización de reventa para crear una CPPO. Para utilizar la autorización de reventa, tanto los proveedores de software independientes (ISV) como los socios de AWS Marketplace canal deben crear un rol vinculado al servicio que proporcione permisos para compartir recursos a. AWS Si ambos grupos no cumplen con este requisito previo, no AWS podrán compartir el recurso de autorización del ISV con el socio de canal. AWS Marketplace Para obtener más información, consulta el artículo Uso de funciones para la autorización de reventa AWS Marketplace en la Guía del AWS Marketplace vendedor.

Crea un CPPO

Utiliza una autorización de reventa dirigida a usted para crear una oferta privada para socios de canal (CPPO) en Draft el estado de Indiana. AWS Marketplace

Si tu solicitud se procesa correctamente, AWS Marketplace Catalog API generará una oferta en el Draft estado con las condiciones de la autorización de reventa. Puedes utilizarla DescribeEntity para ver las condiciones que se aplican al borrador de la oferta en Resale Authorization. Esta oferta está incompleta y los compradores no la pueden ver. AWS Marketplace A continuación, utilizas los tipos de cambios asociados al CPPO para completar la oferta.

Una vez completada la oferta, utiliza el tipo de ReleaseOffer cambio para completar el proceso de creación de la oferta y liberarla. De este modo, se validará toda la oferta y los compradores podrán verla AWS Marketplace.

Para crear una oferta privada para un socio de canal, llama a la operación de la StartChangeSet API con el tipo de CreateOfferUsingResaleAuthorization cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "resaleauthz-123456789",
        "Name": "Test Offer",
        "OfferSetId": "offerset-b3f9EXAMPLE27"
      }
    }
  ]
}

Proporciona información sobre los campos para añadir el tipo de CreateOfferUsingResaleAuthorization cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

La respuesta a esta solicitud indica el estado de la solicitud. Si el estado esSUCCEEDED, OfferId se genera uno nuevo.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef",
  "ChangeSetName": "Submitted by 123456789012",
  "StartTime": "2021-05-27T22:21:26Z",
  "EndTime": "2021-05-27T22:32:19Z",
  "Status": "SUCCEEDED",
  "ChangeSet": [
    {
      "ChangeType": "CreateOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "resaleauthz-123456789",
        "Name": "Test Offer"
      },
      "ErrorDetailList": []
    }
  ]
}

Puedes usar la GET DescribeEntity solicitud para describir el borrador de las reglas y condiciones de la oferta creado a partir ResaleAuthorization de la AWS Marketplace Catalog API Referencia. Para obtener más información, consulte DescribeChangeSet.

Términos y reglas de ResaleAuthorization

{
  "EntityType": "Offer@1.0",
  "EntityIdentifier": "offer-a5EXAMPLEwzpu@1",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:444555666777:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "DetailsDocument": {
    "Id": "offer-3rb23tu92rn",
    "Name": "Test Offer",
    "Description": "Worldwide private offer for Test Product",
    "ProductId": "prod-0bc848d78b51",
    "ResaleAuthorizationId": "resaleauthz-123456789",
    "Terms": [
      {
        "Type": "LegalTerm",
        "Documents": [
          {
            "Type": "CustomEula",
            "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
          }
        ]
      },
      {
        "Type": "ConfigurableUpfrontPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P12M"
            },
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "300.00"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "400.00"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "UsageBasedPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "0.10"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "0.20"
              }
            ]
          }
        ]
      },
      {
        "Type": "PaymentScheduleTerm",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2020-12-01T00:00:00.000Z",
            "ChargeAmount": "1000.00"
          },
          {
            "ChargeDate": "2021-06-15T00:00:00.000Z",
            "ChargeAmount": "1250.00"
          }
        ]
      }
    ],
    "Rules": [
      {
        "Type": "TargetingRule",
        "PositiveTargeting": {
          "BuyerAccounts": [
            "111222333444"
          ]
        }
      }
    ]
  }
}

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. CreateOfferUsingResaleAuthorization AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las CreateOfferUsingResaleAuthorization acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Crea una oferta de reemplazo privada para tu socio de canal

Puedes usar la API del catálogo para crear una oferta de reemplazo privada para un socio de canal en AWS Marketplace.

Para crear en la API Catalog una oferta de reemplazo privada para su socio de canal en el Draft estado, utiliza la que está ResaleAuthorization dirigida a usted y un acuerdo del que es el proponente. Para ello, utilice StartChangeSet el tipo de CreateReplacementOfferUsingResaleAuthorization cambio, tal y como se muestra en el siguiente ejemplo. Las ofertas de sustitución se pueden utilizar para sustituir un acuerdo de una oferta anterior antes de que finalice.

CreateReplacementOfferUsingResaleAuthorizationcreará un borrador de oferta con el destinatario del acuerdo como segmentación. Esta segmentación no se puede cambiar posteriormente. El borrador de la oferta también contendrá el identificador de la oferta de origen del acuerdo.

Para crear una oferta de reemplazo privada para un socio de canal, llama a la operación de StartChangeSet API con el tipo de CreateReplacementOfferUsingResaleAuthorization cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateReplacementOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "2bd2c761-3b7f-3771-a9a7-e8ad36517698",
        "Name": "CAPI-saas-abo-contract-fps",
        "AgreementId": "agmt-f2ooEXAMLEamtm7mjj0j59gu"
      }
    }
  ]
}

Proporcione información sobre los campos para añadir el tipo de CreateReplacementOfferUsingResaleAuthorization cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. CreateReplacementOfferUsingResaleAuthorization AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las CreateReplacementOfferUsingResaleAuthorization acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualice el marcado

Puedes usar la API de catálogo para actualizar las condiciones de precios en función de un porcentaje del valor de tu oferta en AWS Marketplace.

Esto aplicará el margen porcentual indicado a todas las condiciones de precios y condiciones de pago (para futuros calendarios de pago) que defina el fabricante en el ResaleAuthorization. Se sobrescribirá cualquier margen de beneficio existente. Puede ver los precios y condiciones de pago actualizados utilizando. DescribeEntity

Para actualizar el marcado, llama a la operación de StartChangeSet API con el tipo de UpdateMarkup cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateMarkup",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Percentage": "5.0"
      }
    }
  ]
}

Proporcione información sobre los campos para añadir el tipo de UpdateMarkup cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa. Esto incluye validar la información con el equipo de operaciones AWS Marketplace de venta para garantizar que cumpla con las AWS Marketplace directrices. El proceso de validación puede tardar desde unos minutos hasta unas horas.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. UpdateMarkup AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las UpdateMarkup acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualice la configuración de segmentación

Puedes usar la API del catálogo para reemplazar por completo la configuración de segmentación existente AWS Marketplace.

Todas las opciones de segmentación existentes que no estén incluidas en la última solicitud se eliminarán de la oferta. Los fabricantes pueden mencionar a compradores específicos enResaleAuthorization. Los socios de canal pueden ofrecer ofertas privadas a un subconjunto de compradores utilizando PositiveTargeting el tipo de UpdateTargeting cambio.

Para actualizar las configuraciones de segmentación de tu oferta, llama a la operación de la StartChangeSet API con el tipo de UpdateTargeting cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateTargeting",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "PositiveTargeting": {
          "CountryCodes": [
            "US",
            "CA"
          ],
          "BuyerAccounts": [
            "111222333444"
          ]
        },
        "NegativeTargeting": {
          "CountryCodes": [
            "XX"
          ]
        }
      }
    }
  ]
}

Proporciona información sobre los campos para añadir el tipo de UpdateTargeting cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumpla con las AWS Marketplace directrices. El proceso de validación puede tardar desde unos minutos hasta unas horas.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. UpdateTargeting AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las UpdateTargeting acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualice los recursos legales

Puedes usar la API del catálogo para fusionar los términos legales de la autorización de reventa y reemplazar por completo los términos legales existentes. AWS Marketplace

Este cambio no afecta a los acuerdos existentes. Los términos legales que no estén incluidos en la última solicitud se eliminarán de la oferta. Para ver las condiciones legales combinadas, llama al teléfonoDescribeEntity.

Para actualizar los términos legales de tu oferta, llama a la operación de la StartChangeSet API con el tipo de UpdateLegalTerms cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateLegalTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "LegalTerm",
            "Documents": [
              {
                "Type": "CustomEula",
                "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Proporciona información sobre los campos para añadir el tipo de UpdateLegalTerms cambio:

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona el ID del conjunto de cambios.

Sintaxis de respuesta

{
"ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-
1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa. Esto incluye validar la información con el equipo de operaciones AWS Marketplace de venta para garantizar que cumpla con las AWS Marketplace directrices. El proceso de validación puede tardar desde unos minutos hasta unas horas. Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o en la misma DescribeChangeSet acción.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. UpdateLegalTerms AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las UpdateLegalTerms acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualice la visibilidad de la CPPO

Puedes usar la API del catálogo para gestionar la visibilidad de tu oferta en. AWS Marketplace Este tipo de cambio no afecta a los acuerdos existentes.

Puedes elegir establecer una fecha específica en el futuro para restringir la visibilidad de tu oferta o en el pasado para que caduque tu oferta.

Para gestionar la visibilidad de tu oferta, llama a la operación de la StartChangeSet API con el tipo de UpdateAvailability cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateAvailability",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "AvailabilityEndDate": "2024-05-31"
      }
    }
  ]
}

Proporciona información sobre los campos para añadir el tipo de UpdateAvailability cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumpla con las AWS Marketplace directrices. El proceso de validación puede tardar desde unos minutos hasta unas horas.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. UpdateAvailability AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las UpdateAvailability acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Defina la fecha de caducidad de los acuerdos

Puede utilizar la API del catálogo para definir la fecha de caducidad de los acuerdos que se creen con esta oferta en AWS Marketplace.

Este cambio no afecta a los acuerdos existentes. El fabricante podría mencionar la fecha máxima de inicio del acuerdo en una autorización de reventa. Sin embargo, los socios de canal no pueden proporcionar una fecha de inicio del acuerdo posterior a esa fecha.

Para definir la fecha de caducidad de los acuerdos, llama a la operación de la StartChangeSet API con el tipo de UpdateValidityTerms cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateValidityTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "ValidityTerm",
            "AgreementDuration": "P12M",
            "AgreementStartDate": "2021-08-01",
            "AgreementEndDate": "2022-08-01"
          }
        ]
      }
    }
  ]
}

Proporcione información sobre los campos para añadir el tipo de UpdateValidityTerms cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumpla con las AWS Marketplace directrices. El proceso de validación puede tardar desde unos minutos hasta unas horas.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. UpdateValidityTerms AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las UpdateValidityTerms acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualizar los precios

Puedes usar la API del catálogo para reemplazar por completo las condiciones de precios existentes.

Los términos de precios que no estén incluidos en la última solicitud se eliminarán de la oferta. Los socios de canal solo pueden utilizar este tipo de cambio para aprobarloFixedUpFrontPricingTerm.

Para actualizar las condiciones de precios de tus ofertas, llama a la operación de la StartChangeSet API con el tipo de UpdatePricingTerms cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdatePricingTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "Details": {
        "PricingModel": "Contract",
        "Terms": [
          {
            "Type": "FixedUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "Price": "200.00",
            "Duration": "P465D",
            "Grants": [
              {
                "DimensionKey": "Users",
                "MaxQuantity": 10
              }
            ]
          }
        ]
      }
    }
  ]
}

Proporciona información sobre los campos para añadir el tipo de UpdatePricingTerms cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumpla con las AWS Marketplace directrices. El proceso de validación puede tardar desde unos minutos hasta unas horas.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. UpdatePricingTerms AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las UpdatePricingTerms acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualice los detalles del calendario de pagos

Puede utilizar la API del catálogo para cambiar los detalles del calendario de pagos, como el calendario de pagos flexible, en AWS Marketplace.

Si el fabricante ha incluido un calendario de pagos en la autorización de reventa, Channel Partner puede:

Para actualizar los detalles asociados al pago de tu oferta, llama a la operación de la StartChangeSet API con el tipo de UpdatePaymentScheduleTerms cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdatePaymentScheduleTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "PaymentScheduleTerm",
            "Schedule": [
              {
                "ChargeDate": "2021-12-01",
                "ChargeAmount": "200.00"
              },
              {
                "ChargeDate": "2022-03-01",
                "ChargeAmount": "250.00"
              }
            ]
          }
        ]
      }
    }
  ]
}

Proporciona información sobre los campos para añadir el tipo de cambio: UpdatePaymentScheduleTerms

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumpla con las AWS Marketplace directrices. El proceso de validación puede tardar desde unos minutos hasta unas horas.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. UpdatePaymentScheduleTerms AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las UpdatePaymentScheduleTerms acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Publica la CPPO

Puedes usar la API del catálogo para combinar la información recopilada de todos los tipos de cambios de actualización y, a continuación, publicar la oferta en AWS Marketplace ella.

Las ofertas permanecen en un Draft estado hasta que ReleaseOffer se cancelen. Una vez publicada la oferta, se podrá encontrar en AWS Marketplace.

Para publicar tu oferta, llama a la operación de la StartChangeSet API con el tipo de ReleaseOffer cambio, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseOffer",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Proporciona información sobre los campos para añadir el tipo de ReleaseOffer cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información ChangeSetId necesaria ChangeSetArn para el conjunto de cambios y tiene el siguiente aspecto.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumpla con las AWS Marketplace directrices. El proceso de validación puede tardar desde unos minutos hasta unas horas.

Puede comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API del catálogo o directamente mediante la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones de. ReleaseOffer AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas. StartChangeSet Si la solicitud no cumple los siguientes requisitos, fallará y generará una respuesta HTTP.

Errores asíncronos

Los siguientes errores son específicos de las ReleaseOffer acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo DescribeChangeSet obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Defina un CPPO existente

Puede utilizar la API del catálogo para definir los detalles de la CPPO en. AWS Marketplace

Para definir un CPPO existente, llama a la operación de la DescribeEntity API con el tipo de Offer@1.0 entidad, como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

GET /DescribeEntity?catalog=<Catalog>&entityId=<EntityId> HTTP/1.1

Proporcione información sobre los campos para añadir el tipo de DescribeEntity cambio:

Sintaxis de respuesta

La respuesta a esta solicitud proporciona los detalles de la oferta y tiene el siguiente aspecto.

{
  "EntityType": "Offer@1.0",
  "EntityIdentifier": "offer-a5oEXAMPLEzpu@1",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:446235747164:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "Details": {
    "Id": "offer-3rEXAMPLErn",
    "State": "Released",
    "Name": "Test Offer",
    "Description": "Worldwide private offer for Test Product",
    "PreExistingAgreement": {
      "AcquisitionChannel": "External",
      "PricingModel": "Contract"
    },
    "ProductId": "prod-0bEXAMPLEb51",
    "ResaleAuthorizationId": "resaleauthz-123456789",
    "MarkupPercentage": "5.0",
    "Terms": [
      {
        "Type": "LegalTerm",
        "Documents": [
          {
            "Type": "CustomEula",
            "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
          }
        ]
      },
      {
        "Type": "ConfigurableUpfrontPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P12M"
            },
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "300.00"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "400.00"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "UsageBasedPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "0.10"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "0.20"
              }
            ]
          }
        ]
      },
      {
        "Type": "PaymentScheduleTerm",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2020-12-01T00:00:00Z",
            "ChargeAmount": "1000.00"
          },
          {
            "ChargeDate": "2021-06-15T00:00:00Z",
            "ChargeAmount": "1250.00"
          }
        ]
      }
    ],
    "Rules": [
      {
        "Type": "TargetingRule",
        "PositiveTargeting": {
          "CountryCodes": [
            "US",
            "CA"
          ],
          "BuyerAccounts": [
            "118033953248"
          ]
        },
        "NegativeTargeting": {
          "CountryCodes": [
            "XX"
          ]
        }
      },
      {
        "Type": "AvailabilityRule",
        "AvailabilityEndDate": "2050-08-30T01:56:03Z"
      }
    ]
  }
}

Proporciona información para los campos de entrada de la DescribeEntity respuesta: