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.

Trabaje con las autorizaciones de reventa mediante el AWS Marketplace API

Puede utilizarla AWS Marketplace Catalog API para automatizar las tareas relacionadas con las autorizaciones de reventa.

Si bien el producto describe lo que se vende AWS Marketplace, la autorización de reventa (también conocida como oportunidad) describe los términos y las reglas sobre cómo se autoriza la reventa de este producto. AWS Marketplace La CPPO es el objetivo de la autorización de reventa.

La autorización de reventa incluye un conjunto de términos y reglas que deben aceptarse en un acuerdo de reventa entre fabricantes y socios de canal. La aceptación de los términos de la autorización de reventa permite al revendedor crear ofertas para el producto según las condiciones expresadas en los términos.

Hay dos tipos de reglas en una autorización de reventa:

Consulte los siguientes recursos:

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

Requisitos previos para la autorización de reventa

Para usar la autorización de reventa, tanto los proveedores de software independientes (ISV) como los socios de AWS Marketplace canal deben crear una función vinculada 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 nueva autorización de reventa

Puedes usar la API de catálogo para crear una nueva autorización de reventa en. AWS Marketplace

Si su solicitud se procesa correctamente, AWS Marketplace Catalog API generará una autorización de reventa en el Draft estado para usted. Se trata de una autorización de reventa incompleta y los socios de canal no la pueden ver. AWS Marketplace

Usa los tipos de Update cambio para completar la autorización de reventa. Una vez completada la autorización de reventa, utiliza el tipo de ReleaseResaleAuthorization cambio para completar el proceso de creación de la autorización de reventa y liberar la autorización de reventa, que validará toda la autorización de reventa y la hará visible para los socios del canal en su totalidad. AWS Marketplace

Para crear una autorización de reventa en un Draft estado, llama a la operación de la StartChangeSet API con el tipo de CreateResaleAuthorization cambio, tal y como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateResaleAuthorization",
      "ChangeName": "xyz",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0"
      },
      "DetailsDocument":
      {
        "ProductId": "prod-ad8EXAMPLE51",
        "Name": "Test ResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "ResellerAccountId": "777788889999"
      }
    }
  ]
}

Proporcione información sobre los campos de entrada para agregar el tipo de CreateResaleAuthorization 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.

Cuando la solicitud esté completa (si lo Status estáSUCCEEDED), ResaleAuthorization se generará una nueva. Si bien el SUCCEEDED estado indica que la llamada de CreateResaleAuthorization cambio de tipo se ha completado, el ResaleAuthorization estado sigue siendo el Draft mismo.

A continuación se muestra la respuesta de la operación de la DescribeChangeSet API.

{
  "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": "CreateResaleAuthorization",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "ProductId": "prod-ad8EXAMPLE51",
        "Name": "Test ResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "ResellerAccountId": "777788889999",
        "BulkRequestId": "84977023-5093-4a66-8b24-ef2c5a2f8b1f"
      },
      "ErrorDetailList":
      []
    }
  ]
}

Validaciones sincrónicas

Las validaciones del esquema son específicas de las acciones del. CreateResaleAuthorization AWS Marketplace Catalog API Las validaciones se realizan cuando se llama. 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 CreateResaleAuthorization 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 segmentación por compradores

Puedes usar la API de catálogo para actualizar los compradores que segmentan tu autorización de reventa en AWS Marketplace.

Todas las opciones de segmentación existentes que no estén incluidas en la última solicitud se eliminarán de la autorización de reventa. Este tipo de cambio es opcional para liberar la autorización de reventa.

Para actualizar la orientación de los compradores hacia tu autorización de reventa, llama a la operación de la StartChangeSet API con el tipo de UpdateBuyerTargetingTerms cambio, tal y como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

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

{
   "Catalog": "AWSMarketplace",
   "ChangeSet": [        
      {
         "ChangeType":"UpdateBuyerTargetingTerms",
         "Entity":{
            "Type": "ResaleAuthorization@1.0", 
            "Identifier": "resaleauthz-123456789"
         },
         "DetailsDocument":
         {
           "Terms":
           [
             {
               "Type": "BuyerTargetingTerm",
               "PositiveTargeting":
               {
                 "BuyerAccounts":
                 [
                  "123456789012"
                 ]
               }
             }
           ]
         }
      }
   ]
}

Proporciona información sobre los campos para añadir el tipo de UpdateBuyerTargetingTerms 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 validaciones del esquema son específicas de las UpdateBuyerTargetingTerms acciones del. AWS Marketplace Catalog API Estas validaciones se realizan cuando se llama. 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 UpdateBuyerTargetingTerms 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.

Disponibilidad de actualizaciones

Puedes usar la API de catálogo para limitar la disponibilidad del número de ofertas privadas que se crean o hasta el momento específico en que se puede crear una oferta privada.

De forma predeterminada, el valor es el uso ilimitado de esta autorización de reventa, aunque puedes comprobar la disponibilidad en la lista de reglas.

Para controlar la disponibilidad y el uso de tu autorización de reventa, 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": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "AvailabilityEndDate": "2022-05-31",
        "OffersMaxQuantity": 1
      }
    }
  ]
}

Proporciona información sobre los campos para agregar 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 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 validaciones del esquema son específicas de las acciones del. UpdateAvailability AWS Marketplace Catalog API Las validaciones se realizan cuando se llama. 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 las UpdateAvailability acciones de la API de AWS Marketplace Catalog. Estos errores aparecen cuando se llama DescribeChangeSet después de procesar 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 validez de un acuerdo con fecha futura

Puede usar la API de catálogo para modificar y controlar una fecha de inicio de servicio con fecha futura en AWS Marketplace.

Este conjunto de cambios no es obligatorio para emitir una autorización de reventa.

Para modificar y controlar la duración del contrato de producto de tu autorización de reventa, llama a la operación de la StartChangeSet API con el tipo de UpdateBuyerValidityTerms 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": "UpdateBuyerValidityTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "BuyerValidityTerm",
            "MaximumAgreementStartDate": "2024-05-31"
          }
        ]
      }
    }
  ]
}

Proporcione información en los campos de entrada para agregar el tipo de UpdateBuyerValidityTerms 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 validaciones del esquema son específicas de las acciones del. UpdateBuyerValidityTerms AWS Marketplace Catalog API Las validaciones se realizan cuando se llama. 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 UpdateBuyerValidityTerms las 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 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 reemplazar completamente los términos legales existentes AWS Marketplace.

Los términos legales que no estén incluidos en la última solicitud se eliminarán de la autorización de reventa. BuyerLegalTermcontiene el EULA, que se incluirá en el acuerdo final con el comprador, e LegalTerm incluye el contrato de revendedor, que se incluirá en el acuerdo de revendedor entre el socio de canal y el ISV.

Para actualizar sus condiciones legalesResaleAuthorization, llame 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": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "BuyerLegalTerm",
            "Documents":
            [
              {
                "Type": "CustomEula",
                "Url": "https://my-public-bucket.s3.amazonaws.com/eula-example12345.txt"
              }
            ]
          },
          {
            "Type": "ResaleLegalTerm",
            "Documents":
            [
              {
                "Type": "CustomResellerContract",
                "Url": "https://my-public-bucket.s3.amazonaws.com/reseller-example12345.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Proporcione información sobre los campos para agregar el tipo de UpdateLegalTerms 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 validaciones del esquema son específicas de las acciones del. UpdateLegalTerms AWS Marketplace Catalog API Las validaciones se realizan cuando se llama. 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 llamaDescribeChangeSet, después de que se procese 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 AWS Marketplace.

Las condiciones de precios que no estén incluidas en la última solicitud se eliminarán de la autorización de reventa. Puedes actualizar los precios con descuento de tu producto a través de esta API.

Para actualizar los detalles de precios de tus autorizaciones de reventa, llama a la operación de la StartChangeSet API indicando 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": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "PricingModel": "Contract",
        "Terms":
        [
          {
            "Type": "ResaleUsageBasedPricingTerm",
            "CurrencyCode": "USD",
            "RateCards":
            [
              {
                "RateCard":
                [
                  {
                    "DimensionKey": "m3.large",
                    "Price": "0.10"
                  },
                  {
                    "DimensionKey": "m4.xlarge",
                    "Price": "0.20"
                  }
                ]
              }
            ]
          },
          {
            "Type": "ResaleConfigurableUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "RateCards":
            [
              {
                "Selector":
                {
                  "Type": "Duration",
                  "Value": "P12M"
                },
                "RateCard":
                [
                  {
                    "DimensionKey": "m3.large",
                    "Price": "300"
                  },
                  {
                    "DimensionKey": "m4.xlarge",
                    "Price": "400"
                  }
                ],
                "Constraints":
                {
                  "MultipleDimensionSelection": "Allowed",
                  "QuantityConfiguration": "Allowed"
                }
              }
            ]
          },
          {
            "Type": "ResaleFixedUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "Duration": "P2M",
            "Price": "200.0",
            "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 UpdatePricingTerms acciones de la API de AWS Marketplace Catalog. Las validaciones se realizan cuando usted llama. 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 el calendario de pagos

Puedes usar la API de catálogo para cambiar los detalles asociados al pago, como un calendario de pagos flexible, en. AWS Marketplace

Para actualizar los detalles asociados al pago de tu autorización de reventa, 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": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "ResalePaymentScheduleTerm",
            "CurrencyCode": "USD",
            "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 validaciones del esquema son específicas de las acciones del. UpdatePaymentScheduleTerms AWS Marketplace Catalog API Las validaciones se realizan cuando se llama. 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 aparecen cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre el uso DescribeChangeSet para obtener el estado de una solicitud de cambio, consulte. Trabajar con conjuntos de cambios

Actualizar las condiciones de pago neto

Puedes usar la API de catálogo para establecer las condiciones de pago netas de tu autorización de reventa en AWS Marketplace. Un plazo de pago neto es un plazo en el que especificas el número de días transcurridos desde la emisión de la factura en los que vence el pago.

El plazo de pago neto que estableces en una autorización de reventa es el plazo máximo que el socio de canal puede ofrecer a un comprador en una oferta privada para socios de canal (CPPO). El socio del canal puede ofrecer el mismo período o uno más corto, pero no uno más largo. Para obtener más información, consulte Crea una CPPO.

Para establecer el plazo de pago neto de tu autorización de reventa, llama a la operación de la StartChangeSet API con el tipo de UpdateNetPaymentTerms cambio, tal y como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateNetPaymentTerms",
      "Entity": {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "ResaleNetPaymentTerm",
            "PaymentDuePeriod": "P60D"
          }
        ]
      }
    }
  ]
}

Proporciona información sobre los campos para añadir el tipo de UpdateNetPaymentTerms 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 unos minutos.

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. 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 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 de la autorización de reventa

Puedes usar la API de catálogo para actualizar los detalles de la autorización de reventa en. AWS Marketplace

Para actualizar los detalles de la autorización de reventa, llame a la operación de la StartChangeSet API con el tipo de UpdateInformation 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": "UpdateInformation",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Name": "TestResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "PreExistingBuyerAgreement":
        {
          "AcquisitionChannel": "AwsMarketplace",
          "PricingModel": "Contract"
        }
      }
    }
  ]
}

Proporcione información sobre los campos para agregar el tipo de UpdateInformation 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. UpdateInformation AWS Marketplace Catalog API Estas validaciones se realizan al llamar StartChangeSet y la solicitud fallará con un error HTTP si la entrada no cumple los siguientes requisitos.

Errores asincrónicos

Los siguientes errores son específicos de UpdateInformation las acciones del. AWS Marketplace Catalog API Estos errores aparecen cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre el uso DescribeChangeSet para obtener el estado de una solicitud de cambio, consulte. Trabajar con conjuntos de cambios

Restringir una autorización de reventa

Puedes usar la API de catálogo para establecer reglas de restricción para una autorización de reventa en. AWS Marketplace

Un socio de canal ya no puede usar una autorización de reventa restringida para crear una oferta privada. Las ofertas privadas existentes no se verán afectadas.

Para restringir tu autorización de reventa, llama a la operación de la StartChangeSet API con el tipo de RestrictResaleAuthorization 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": "RestrictResaleAuthorization",
      "Entity": {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Proporcione información sobre los campos para agregar el tipo de RestrictResaleAuthorization 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 validaciones del esquema son específicas de las RestrictResaleAuthorization acciones de la API de AWS Marketplace Catalog. Estas validaciones se realizan cuando llama. 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 RestrictResaleAuthorization las acciones del. AWS Marketplace Catalog API Estos errores aparecen cuando se llama DescribeChangeSet después de que se esté procesando un conjunto de cambios. Para obtener más información sobre el uso DescribeChangeSet para obtener el estado de una solicitud de cambio, consulte. Trabajar con conjuntos de cambios

Liberar una autorización de reventa y hacerla visible para un socio de canal

Puedes usar la API de catálogo para iniciar tu viaje ResaleAuthorization a un Active estado.

ReleaseResaleAuthorizationactiva tu autorización de reventa para que un socio de canal pueda usar tu autorización de reventa para crear ofertas privadas.

Para liberar tu autorización de reventa, llama a la operación de la StartChangeSet API con el tipo de ReleaseResaleAuthorization cambio, tal y como se muestra en el siguiente ejemplo.

Sintaxis de la solicitud

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "ReleaseResaleAuthorization",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

Proporcione información sobre los campos para agregar el tipo de ReleaseResaleAuthorization 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 validaciones del esquema son específicas de las acciones del. ReleaseResaleAuthorization AWS Marketplace Catalog API Las validaciones se realizan cuando se llama. 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 ReleaseResaleAuthorization 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 el uso DescribeChangeSet para obtener el estado de una solicitud de cambio, consulteTrabajar con conjuntos de cambios.

Describa una autorización de reventa existente

Para describir los detalles de la autorización de reventa, llama a la operación de la DescribeEntity API con el tipo de ResaleAuthorization@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": "ResaleAuthorization@1.0",
  "EntityIdentifier": "resaleauthz-123456789",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/ResaleAuthorization/resaleauthz-123456789",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "DetailsDocument": {
    "Name": "TestResaleAuthorization",
    "Description": "ResaleAuthorization for Test Product",
    "ProductId": "prod-ad8EXAMPLE51",
    "ProductName": "TestProduct",
    "Status": "Active", /*Draft, Active, Restricted*/
    "PreExistingBuyerAgreement": {
      "AcquisitionChannel": "Unknown",
      "PricingModel": "Unknown"
    },
    "CreatedDate": "2023-07-18T16:39:31.335Z",
    "ManufacturerLegalName": "ChannelCAPI.Inc",
    "ManufacturerAccountId": "123456789012",
    "Dimensions": [
      {
        "Name": "Protected Resources",
        "Description": "Additional 100 protected resources",
        "Key": "hundredresources",
        "Unit": "Units",
        "Types": [
          "Entitled"
        ]
      }
    ],
    "OfferDetails": {
      "OfferExtendedStatus": "Not Started", /* Not Started, Completed-Used, Completed-Usable*/
      "OfferCreatedCount": 0
    },
    "Terms": [
      {
        "Type": "ResaleNetPaymentTerm",
        "Id": "term_id_placeholder",
        "PaymentDuePeriod": "P60D"
      },
      {
        "Type": "ResaleUsageBasedPricingTerm",
        "Id": "term_id_placeholder",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "resource_number",
                "Price": "0.05"
              },
              {
                "DimensionKey": "scanned_data",
                "Price": "0.05"
              }
            ]
          }
        ]
      },
      {
        "Type": "ResaleConfigurableUpfrontPricingTerm",
        "Id": "term_id_placeholder",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P24M"
            },
            "RateCard": [
              {
                "DimensionKey": "hundredresources",
                "Price": "0.04"
              },
              {
                "DimensionKey": "tenTBData",
                "Price": "0.03"
              },
              {
                "DimensionKey": "channel_custom",
                "Price": "0.02"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "ResaleFixedUpfrontPricingTerm",
        "Id": "term-sdh27fb2",
        "CurrencyCode": "USD",
        "Duration": "P180D",
        "Price": "0.0",
        "Grants": [
          {
            "DimensionKey": "sdf73rbns93nl120d10xm1",
            "MaxQuantity": 1
          }
        ]
      },
      {
        "Type": "ResalePaymentScheduleTerm",
        "Id": "term-sdh27fb2",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2018-07-01T00:00:00.000Z",
            "ChargeAmount": "200.00"
          },
          {
            "ChargeDate": "2019-05-01T00:00:00.000Z",
            "ChargeAmount": "200.00"
          }
        ]
      },
      {
        "Type": "BuyerLegalTerm",
        "Id": "term_id_placeholder",
        "Documents": [
          {
            "Type": "StandardEula",
            "Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/a85cace8-6d9d-40ca-a053-78fc265479bf?isSigned=yes"
          }
        ]
      },
      {
        "Type": "ResaleLegalTerm",
        "Id": "term_id_placeholder",
        "Documents": [
          {
            "Type": "StandardResellerContract",
            "Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/bed55b56-7ab4-4c4c-b633-3bf4f6efcb98?isSigned=yes"
          }
        ]
      },
      {
        "Type": "BuyerValidityTerm",
        "Id": "term_id_placeholder",
        "MaximumAgreementStartDate": "2023-09-25T23:59:59.000Z"
      },
      {
        "Type": "BuyerTargetingTerm",
        "Id": "term_id_placeholder",
        "PositiveTargeting": {
          "BuyerAccounts": [
            {
              "AwsAccountId": "444455556666"
            }
          ]
        }
      }
    ],
    "Rules": [
      {
        "Type": "AvailabilityRule",
        "Id": "availability_rule_id_placeholder",
        /* If the AvailabilityEndDate and OffersMaxQuantity not present Usage will be Unlimited*/
        "Usage": "Limited",
        "AvailabilityEndDate": "2022-05-31T23:59:59Z",
        "OffersMaxQuantity": 1
      },
      {
        "Type": "PartnerTargetingRule",
        "Id": "partner_targeting_rule_id_placeholder",
        "ResellerAccountId": "777777777777",
        "ResellerLegalName": "ChannelCAPICP.Inc"
      }
    ]
  }
}

La siguiente es información sobre los campos que ves en la DescribeEntity respuesta.