Se reestructuró la referencia de la 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.

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

Puedes utilizarlas AWS Marketplace Catalog API para automatizar las tareas relacionadas con las ofertas privadas de los socios de canal (CPPO).

Al crear o actualizar una CPPO, el borrador de la oferta contendrá los términos y las reglas de la autorización de reventa y será invisible para el comprador. 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 otra 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 actualizar ciertas partes de una oferta. Sin embargo, solo puedes conceder permisos de lectura a las autorizaciones de reventa.

Como requisito previo para cambiar los tipos de llamadas, debes 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 para socios del canal en la Guía del AWS Marketplace vendedor.

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

Requisitos previos de CPPO

Service-linked la configuración del rol ResaleAuthorization (SLR) es un requisito previo obligatorio para utilizar la autorización de reventa y 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 a un servicio que proporcione permisos para compartir recursos. 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 Cómo usar funciones para la autorización de reventa AWS Marketplace en la Guía del AWS Marketplace vendedor.

Crea una CPPO

Usas una autorización de reventa dirigida a ti para crear una oferta privada para socios de canal (CPPO) en el estado enDraft. AWS Marketplace

Si tu solicitud se procesa correctamente, AWS Marketplace Catalog API generará una oferta en el Draft estado para ti con las condiciones de la autorización de reventa. Puedes utilizarla DescribeEntity para ver las condiciones aplicadas al borrador de la oferta de reventa. Se trata de una oferta incompleta y los compradores no la pueden ver en AWS Marketplace. A continuación, utiliza los tipos de cambio asociados a la CPPO para completar la oferta.

Una vez finalizada la oferta, utiliza el tipo de ReleaseOffer cambio para completar el proceso de creación de la oferta y liberarla. Esto validará toda la oferta y la hará visible para los compradores en 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 le proporciona la dirección ChangeSetId y 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.

Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de 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 del. CreateOfferUsingResaleAuthorization AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de CreateOfferUsingResaleAuthorization las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Crea una oferta de sustitución privada para un socio de canal

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

Utiliza la oferta ResaleAuthorization dirigida a ti y un acuerdo del que eres el proponente para crear una oferta sustitutiva privada para un socio de canal en Draft estado en la API de catálogo llamando StartChangeSet con el tipo de CreateReplacementOfferUsingResaleAuthorization cambio, como se muestra en el siguiente ejemplo. Las ofertas de sustitución se pueden usar para reemplazar un acuerdo de una oferta anterior antes de que finalice.

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

Para crear una oferta de sustitución privada para un socio de canal, llama a la operación de la 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"
      }
    }
  ]
}

Proporciona 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 le proporciona la dirección ChangeSetId y 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.

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

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. CreateReplacementOfferUsingResaleAuthorization AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de CreateReplacementOfferUsingResaleAuthorization las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualizar el marcado

Puedes usar la API de catálogo para actualizar las condiciones de precios según un valor porcentual en tu oferta en AWS Marketplace.

Esto aplicará el margen porcentual dado a todos los términos 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 las condiciones de pago actualizados utilizando. DescribeEntity

Para actualizar el marcado, llama a la operación de la 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 agregar el tipo de UpdateMarkup cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección ChangeSetId y 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 del AWS Marketplace vendedor para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar entre unos minutos y unas horas.

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

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. UpdateMarkup AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de UpdateMarkup las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualizar la configuración de segmentación

Puedes usar la API de 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 objetivo 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 le proporciona la dirección ChangeSetId y 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 cumple 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 de catálogo o directamente a través de la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las UpdateTargeting acciones del. AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de UpdateTargeting las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualizar los recursos legales

Puedes usar la API de catálogo para combinar 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. Las condiciones legales que no estén incluidas en la última solicitud se eliminarán de la oferta. Puedes ver las condiciones legales combinadas llamandoDescribeEntity.

Para actualizar las condiciones 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 identificador 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 del AWS Marketplace vendedor para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar entre unos minutos y unas horas. Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o en la API de catálogo con la DescribeChangeSet acción.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. UpdateLegalTerms AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de UpdateLegalTerms las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualice la capacidad de detección de la CPPO

Puedes usar la API de 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 le proporciona la dirección ChangeSetId y 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 cumple 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 de catálogo o directamente a través de la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. UpdateAvailability AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de UpdateAvailability las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Definir la fecha de caducidad de los acuerdos

Puedes usar la API de catálogo para definir la fecha de vencimiento de los acuerdos que se crean 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 agregar el tipo de UpdateValidityTerms cambio:

Sintaxis de respuesta

Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección ChangeSetId y 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 cumple 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 de catálogo o directamente a través de la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. UpdateValidityTerms AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de UpdateValidityTerms las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualizar los precios

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

Las condiciones de precios que no estén incluidas en la última solicitud se eliminarán de la oferta. Los socios de canal solo pueden usar 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 le proporciona la dirección ChangeSetId y 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 cumple 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 de catálogo o directamente a través de la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. UpdatePricingTerms AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de UpdatePricingTerms las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualizar los detalles del calendario de pagos

Puedes usar la API de catálogo para cambiar los detalles del cronograma de pagos, como el cronograma de pagos flexible, en AWS Marketplace.

Si el fabricante ha proporcionado un calendario de pagos en la autorización de reventa, el socio de canal 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 le proporciona la dirección ChangeSetId y 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 cumple 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 de catálogo o directamente a través de la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. UpdatePaymentScheduleTerms AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de UpdatePaymentScheduleTerms las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Actualizar las condiciones de pago neto

Si la autorización de reventa que utilizas para crear una oferta privada para socios de canal (CPPO) contiene un plazo de pago neto, ese plazo es el período máximo que puedes ofrecer al comprador. El plazo de la autorización de reventa se aplica automáticamente a tu CPPO cuando la creas.

Para ofrecer a tu comprador un período de pago más corto que el autorizado por el vendedor, llama a la operación de la StartChangeSet API indicando el tipo de UpdateNetPaymentTerms cambio en tu oferta, como se muestra en el siguiente ejemplo. Si quieres usar el mismo período que el vendedor autorizó, no es necesario que llamesUpdateNetPaymentTerms.

Si la autorización de reventa no contiene un plazo de pago neto, no puedes añadir uno a la CPPO y se aplicarán las condiciones de pago del comprador. AWS Tampoco puedes eliminar el plazo de pago neto de una CPPO si la autorización de reventa contiene uno.

Sintaxis de la solicitud

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateNetPaymentTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "NetPaymentTerm",
            "PaymentDuePeriod": "P30D"
          }
        ]
      }
    }
  ]
}

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

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. UpdateNetPaymentTerms AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de UpdateNetPaymentTerms las acciones realizadas en una CPPO en. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Publica la CPPO

Puedes usar la API de 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.

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

Para publicar tu oferta, llama a la operación de la StartChangeSet API con el tipo de ReleaseOffer cambio que 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 le proporciona la dirección ChangeSetId y 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 cumple 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 de catálogo o directamente a través de la operación de la DescribeChangeSet API.

Validaciones sincrónicas

Las siguientes validaciones de esquema son específicas de las acciones del. ReleaseOffer AWS Marketplace Catalog API Estas validaciones se realizan al llamar. StartChangeSet Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.

Errores asincrónicos

Los siguientes errores son específicos de ReleaseOffer las acciones del. 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 utilizarlos para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Definir una CPPO existente

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

Para definir una CPPO existente, llame 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 agregar 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"
      }
    ]
  }
}

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