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 autorizaciones de reventa utilizando el AWS Marketplace API

Puede utilizarlas AWS Marketplace Catalog API para automatizar las tareas de trabajo 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 normas que rigen la autorización para la reventa de este producto. AWS Marketplace La CPPO es el objetivo de la autorización de reventa.

Una autorización de reventa incluye un conjunto de condiciones y normas 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 distribuidor 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 utilizar la API de catálogo para crear y actualizar las autorizaciones de reventa:

Requisitos previos para la autorización de reventa

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 otorgue 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 el artículo Uso de funciones para la autorización de reventa AWS Marketplace en la Guía del AWS Marketplace vendedor.

Crea una nueva autorización de reventa

Puede utilizar la API del 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 vigente para Draft usted. Es una autorización de reventa incompleta y los socios del canal no la pueden ver. AWS Marketplace

Utilice los tipos de Update cambios para completar la autorización de reventa. Una vez completada la autorización de reventa, utilice 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. AWS Marketplace

Para crear una autorización de reventa en Draft estado, llama a la operación de StartChangeSet API con el tipo de CreateResaleAuthorization 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": "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 añadir el tipo de CreateResaleAuthorization 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.

Cuando se completa la solicitud (si lo Status estáSUCCEEDED), ResaleAuthorization se genera una nueva. Aunque el SUCCEEDED estado indica que la llamada de CreateResaleAuthorization cambio de tipo se ha completado, el ResaleAuthorization estado sigue en ese Draft estado.

A continuación se muestra la respuesta de la operación de la DescribeChangeSetAPI.

{
  "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 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 CreateResaleAuthorization 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.

Actualiza la segmentación por compradores

Puedes usar la API del catálogo para actualizar la segmentación de los compradores por tu autorización de reventa. 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 la emisión de la autorización de reventa.

Para actualizar la segmentación de los compradores por tu autorización de reventa, llama a la operación de la StartChangeSet API con el tipo de UpdateBuyerTargetingTerms 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":"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 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 validaciones del esquema son específicas de las acciones del. UpdateBuyerTargetingTerms 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 UpdateBuyerTargetingTerms 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 la disponibilidad

Puedes usar la API del catálogo para limitar la disponibilidad del número de ofertas privadas que se crean o hasta qué hora específica 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 la usabilidad de tu autorización de reventa, llama a la operación de 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
      }
    }
  ]
}

Proporcione 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 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 validaciones del esquema son específicas de las acciones del. UpdateAvailability AWS Marketplace Catalog API Las 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 la API del catálogo de AWS Marketplace. Estos errores se devuelven cuando 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 la validez de un acuerdo con fecha futura

Puede usar la API de catálogo para modificar y controlar la fecha de inicio de un 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 acuerdo de producto de tu autorización de reventa, llama a la operación de 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 sobre los campos de entrada para añadir el tipo de UpdateBuyerValidityTerms 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 validaciones del esquema son específicas de las acciones del. UpdateBuyerValidityTerms AWS Marketplace Catalog API Las 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 UpdateBuyerValidityTerms 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 reemplazar por completo los términos legales existentes en 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 del 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 añadir el tipo de UpdateLegalTerms 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 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 validaciones del esquema son específicas de las acciones del. UpdateLegalTerms AWS Marketplace Catalog API Las 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 al llamarDescribeChangeSet, 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 de catálogo para reemplazar por completo las condiciones de precios existentes en AWS Marketplace.

Los términos de precios que no estén incluidos 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 los precios de tus autorizaciones de reventa, 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": "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 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 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 esquemas son específicas de las UpdatePricingTerms acciones de la API del catálogo de AWS Marketplace. Las validaciones se realizan cuando usted llama. 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.

Actualiza el calendario de pagos

Puedes usar la API de catálogo para cambiar los detalles asociados a los pagos, 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 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 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 validaciones del esquema son específicas de las acciones del. UpdatePaymentScheduleTerms AWS Marketplace Catalog API Las 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, consulte. Trabajar con conjuntos de cambios

Actualice los detalles de la autorización de reventa

Puede utilizar la API del 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, llama 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 añadir el tipo de UpdateInformation 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 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. UpdateInformation AWS Marketplace Catalog API Estas validaciones se realizan cuando llamas StartChangeSet y la solicitud fallará con un error HTTP si la entrada no cumple los siguientes requisitos.

Errores asíncronos

Los siguientes errores son específicos de las UpdateInformation 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, consulte. Trabajar con conjuntos de cambios

Restrinja una autorización de reventa

Puede utilizar la API del catálogo para establecer reglas que restrinjan una autorización de reventa en. AWS Marketplace

Un socio de canal ya no puede utilizar una autorización de reventa restringida para crear una oferta privada. Una oferta privada existente no se verá afectada.

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 añadir el tipo de RestrictResaleAuthorization 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 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 validaciones del esquema son específicas de las RestrictResaleAuthorization acciones de la API del catálogo de AWS Marketplace. Estas validaciones se realizan cuando usted llama. 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 RestrictResaleAuthorization 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, consulte. Trabajar con conjuntos de cambios

Emita una autorización de reventa y hágala visible para un socio de canal

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

ReleaseResaleAuthorizationactiva tu autorización de reventa para que un socio de canal pueda utilizarla 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, 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": {}
    }
  ]
}

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

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 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": "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": "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.