L'API Reference di AWS Marketplace è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Marketplace API Reference.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lavora con le autorizzazioni di rivendita utilizzando AWS Marketplace API

Puoi utilizzarlo AWS Marketplace Catalog API per automatizzare le attività relative alle autorizzazioni di rivendita.

Mentre il prodotto descrive ciò che viene venduto AWS Marketplace, l'autorizzazione alla rivendita (nota anche come opportunità) descrive i termini e le regole relative alle modalità di autorizzazione alla rivendita del prodotto. AWS Marketplace Il CPPO è l'obiettivo dell'autorizzazione alla rivendita.

L'autorizzazione alla rivendita contiene una serie di termini e regole da accettare per un accordo di rivendita tra produttori e partner di canale. L'accettazione dei termini dell'autorizzazione alla rivendita consente al rivenditore di creare offerte per il prodotto in base alle condizioni espresse nei termini.

Esistono due tipi di regole in un'autorizzazione alla rivendita:

Consulta le seguenti risorse:

I seguenti argomenti descrivono come utilizzare l'API del catalogo per creare e aggiornare le autorizzazioni di rivendita:

Prerequisiti per l'autorizzazione alla rivendita

Per utilizzare l'autorizzazione alla rivendita, sia i fornitori di software indipendenti (ISV) che i partner di AWS Marketplace canale devono creare un ruolo collegato ai servizi che fornisca le autorizzazioni di condivisione delle risorse a. AWS Se entrambi i gruppi non soddisfano questo prerequisito, non AWS possono condividere la risorsa di autorizzazione dall'ISV al Channel Partner. AWS Marketplace Per ulteriori informazioni, consulta la sezione Utilizzo dei ruoli per l'autorizzazione alla rivendita AWS Marketplace nella Guida per il AWS Marketplace venditore.

Crea una nuova autorizzazione alla rivendita

Puoi utilizzare l'API del catalogo per creare una nuova autorizzazione di rivendita in. AWS Marketplace

Se la tua richiesta viene elaborata correttamente, AWS Marketplace Catalog API genera un'autorizzazione di rivendita in Draft stato per te. Si tratta di un'autorizzazione alla rivendita incompleta e non visibile ai partner di canale in. AWS Marketplace

Utilizza i tipi di Update modifica per completare l'autorizzazione alla rivendita. Una volta completata l'autorizzazione alla rivendita, utilizza il tipo di ReleaseResaleAuthorization modifica per completare il processo di creazione dell'autorizzazione alla rivendita e rilasciare l'autorizzazione alla rivendita, che convaliderà l'intera autorizzazione alla rivendita e la renderà visibile ai partner di canale in. AWS Marketplace

Per creare un'autorizzazione alla rivendita nello Draft stato, richiama l'operazione StartChangeSet API con il tipo di CreateResaleAuthorization modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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"
      }
    }
  ]
}

Fornisci informazioni per i campi di input per aggiungere il tipo di CreateResaleAuthorization modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Quando la richiesta è completa (se lo Status èSUCCEEDED), ne ResaleAuthorization viene generata una nuova. Sebbene lo SUCCEEDED stato indichi che la chiamata di CreateResaleAuthorization modifica del tipo di chiamata è stata completata, lo ResaleAuthorization stato è ancora Draft attivo.

Quanto segue mostra la risposta dell'operazione 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":
      []
    }
  ]
}

Validazioni sincrone

Le convalide dello schema sono specifiche per CreateResaleAuthorization le azioni in. AWS Marketplace Catalog API Le convalide vengono eseguite quando si chiama. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici CreateResaleAuthorization delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.

Aggiorna il targeting per gli acquirenti

Puoi utilizzare l'API del catalogo per aggiornare gli acquirenti che hanno come target la tua autorizzazione di rivendita in. AWS Marketplace

Tutte le opzioni di targeting esistenti non incluse nell'ultima richiesta vengono rimosse dall'autorizzazione alla rivendita. Questo tipo di modifica è facoltativo per il rilascio dell'autorizzazione alla rivendita.

Per aggiornare gli acquirenti interessati alla tua autorizzazione di rivendita, chiama l'operazione StartChangeSet API indicando il tipo di UpdateBuyerTargetingTerms modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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"
                 ]
               }
             }
           ]
         }
      }
   ]
}

Fornisci informazioni per i campi per aggiungere il tipo di UpdateBuyerTargetingTerms modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni con il team AWS Marketplace Seller Operations per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema sono specifiche per UpdateBuyerTargetingTerms le azioni in. AWS Marketplace Catalog API Queste convalide vengono eseguite quando si chiama. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici UpdateBuyerTargetingTerms delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.

Disponibilità degli aggiornamenti

Puoi utilizzare l'API del catalogo per limitare la disponibilità del numero di offerte private create o fino a che ora specifica può essere creata un'offerta privata.

Per impostazione predefinita, il valore è l'utilizzo illimitato di questa autorizzazione di rivendita, sebbene sia possibile verificare la disponibilità nell'elenco delle regole.

Per controllare la disponibilità e l'usabilità dell'autorizzazione di rivendita, richiama l'operazione StartChangeSet API con il tipo di UpdateAvailability modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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
      }
    }
  ]
}

Fornisci informazioni per i campi per aggiungere il tipo di UpdateAvailability modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni con il team AWS Marketplace Seller Operations per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema sono specifiche per UpdateAvailability le azioni in. AWS Marketplace Catalog API Le convalide vengono eseguite quando si chiama. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP

Errori asincroni

I seguenti errori sono specifici UpdateAvailability delle azioni nell'API AWS Marketplace Catalog. Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.

Aggiornare la validità di un accordo con data futura

Puoi utilizzare l'API Catalog per modificare e controllare una data di inizio del servizio con data futura in AWS Marketplace.

Questo set di modifiche non è obbligatorio per il rilascio di un'autorizzazione di rivendita.

Per modificare e controllare la durata dell'autorizzazione alla rivendita del contratto di prodotto, richiama l'operazione StartChangeSet API con il tipo di UpdateBuyerValidityTerms modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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"
          }
        ]
      }
    }
  ]
}

Fornisci informazioni per i campi di input per aggiungere il tipo di UpdateBuyerValidityTerms modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni con il team AWS Marketplace Seller Operations per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema sono specifiche per UpdateBuyerValidityTerms le azioni in. AWS Marketplace Catalog API Le convalide vengono eseguite quando si chiama. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici UpdateBuyerValidityTerms delle azioni in AWS Marketplace Catalog API. Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.

Aggiornamento delle risorse legali

Puoi utilizzare l'API del catalogo per sostituire completamente i termini legali esistenti in AWS Marketplace.

I termini legali non inclusi nell'ultima richiesta verranno rimossi dall'autorizzazione alla rivendita. BuyerLegalTermcontiene l'EULA che sarà incluso nel contratto con l'acquirente finale e LegalTerm include il contratto di rivendita che sarà incluso nel contratto di rivendita tra il partner di canale e l'ISV.

Per aggiornare i tuoi termini legaliResaleAuthorization, chiama l'operazione StartChangeSet API indicando il tipo di UpdateLegalTerms modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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"
              }
            ]
          }
        ]
      }
    }
  ]
}

Fornisci informazioni per i campi per aggiungere il tipo di UpdateLegalTerms modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema sono specifiche per UpdateLegalTerms le azioni in. AWS Marketplace Catalog API Le convalide vengono eseguite quando si chiama. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici UpdateLegalTerms delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiamaDescribeChangeSet, dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.

Aggiorna i prezzi

Puoi utilizzare l'API del catalogo per sostituire completamente le condizioni tariffarie esistenti in AWS Marketplace.

Le condizioni tariffarie non incluse nell'ultima richiesta verranno rimosse dall'autorizzazione alla rivendita. Puoi aggiornare i prezzi scontati per il tuo prodotto tramite questa API.

Per aggiornare i dettagli dei prezzi per le autorizzazioni di rivendita, richiama l'operazione StartChangeSet API con il tipo di UpdatePricingTerms modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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
              }
            ]
          }
        ]
      }
    }
  ]
}

Fornisci informazioni per i campi per aggiungere il tipo di UpdatePricingTerms modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le seguenti convalide dello schema sono specifiche per le UpdatePricingTerms azioni nell'API AWS Marketplace Catalog. Le convalide vengono eseguite al momento della chiamata. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici UpdatePricingTerms delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.

Aggiorna il piano di pagamento

Puoi utilizzare l'API Catalog per modificare i dettagli associati ai pagamenti, ad esempio un programma di pagamento flessibile, in. AWS Marketplace

Per aggiornare i dettagli associati ai pagamenti per l'autorizzazione alla rivendita, richiama l'operazione StartChangeSet API indicando il tipo di UpdatePaymentScheduleTerms modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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"
              }
            ]
          }
        ]
      }
    }
  ]
}

Fornisci informazioni per i campi per aggiungere il tipo di modifica: UpdatePaymentScheduleTerms

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema sono specifiche per UpdatePaymentScheduleTerms le azioni in. AWS Marketplace Catalog API Le convalide vengono eseguite quando si chiama. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici UpdatePaymentScheduleTerms delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedere. Utilizzo dei set di modifiche

Aggiornamento dei termini di pagamento netti

Puoi utilizzare l'API del catalogo per impostare i termini di pagamento netti della tua autorizzazione di rivendita in AWS Marketplace. Un termine di pagamento netto è un termine in cui si specifica il numero di giorni dopo l'emissione della fattura entro il quale il pagamento è dovuto.

Il termine di pagamento netto impostato in un'autorizzazione alla rivendita è il termine massimo che il partner di canale può offrire a un acquirente in un'offerta privata (CPPO) del partner di canale. Il partner di canale può offrire lo stesso periodo o uno più breve, ma non uno più lungo. Per ulteriori informazioni, consulta Crea un CPPO.

Per impostare il termine di pagamento netto dell'autorizzazione alla rivendita, chiama l'operazione StartChangeSet API con il tipo di UpdateNetPaymentTerms modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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"
          }
        ]
      }
    }
  ]
}

Fornisci informazioni per i campi per aggiungere il tipo di UpdateNetPaymentTerms modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere alcuni minuti.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le seguenti convalide dello schema sono specifiche per UpdateNetPaymentTerms le azioni in. AWS Marketplace Catalog API Queste convalide vengono eseguite quando si chiama. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici UpdateNetPaymentTerms delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.

Aggiorna i dettagli dell'autorizzazione alla rivendita

Puoi utilizzare l'API del catalogo per aggiornare i dettagli dell'autorizzazione alla rivendita in. AWS Marketplace

Per aggiornare i dettagli dell'autorizzazione alla rivendita, richiama l'operazione StartChangeSet API con il tipo di UpdateInformation modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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"
        }
      }
    }
  ]
}

Fornisci informazioni per i campi per aggiungere il tipo di UpdateInformation modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le seguenti convalide dello schema sono specifiche per UpdateInformation le azioni in. AWS Marketplace Catalog API Queste convalide vengono eseguite quando si chiama StartChangeSet e la richiesta avrà esito negativo con un errore HTTP se l'input non soddisfa i seguenti requisiti.

Errori asincroni

Gli errori seguenti sono specifici UpdateInformation delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedere. Utilizzo dei set di modifiche

Limita un'autorizzazione di rivendita

Puoi utilizzare l'API del catalogo per impostare regole di restrizione all'autorizzazione di rivendita in. AWS Marketplace

Un'autorizzazione di rivendita limitata non può più essere utilizzata da un partner di canale per creare un'offerta privata. Un'offerta privata esistente non sarà influenzata.

Per limitare l'autorizzazione alla rivendita, richiama l'operazione StartChangeSet API con il tipo di RestrictResaleAuthorization modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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

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

Fornisci informazioni per i campi per aggiungere il tipo di RestrictResaleAuthorization modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema sono specifiche per le RestrictResaleAuthorization azioni nell'API AWS Marketplace Catalog. Queste convalide vengono eseguite quando chiami. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici RestrictResaleAuthorization delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedere. Utilizzo dei set di modifiche

Rilascia un'autorizzazione alla rivendita e rendila visibile a un partner di canale

Puoi utilizzare l'API del catalogo per iniziare a passare ResaleAuthorization a uno Active stato.

ReleaseResaleAuthorizationattiva la tua autorizzazione alla rivendita in modo che un partner di canale possa utilizzare la tua autorizzazione alla rivendita per creare offerte private.

Per rilasciare la tua autorizzazione alla rivendita, chiama l'operazione StartChangeSet API con il tipo di ReleaseResaleAuthorization modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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

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

Fornisci informazioni per i campi per aggiungere il tipo di ReleaseResaleAuthorization modifica:

Sintassi della risposta

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la ChangeSetId e ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni per garantire che soddisfino le linee guida. AWS Marketplace Il processo di convalida può richiedere da pochi minuti a qualche ora.

Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione AWS Marketplace l'API del catalogo utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema sono specifiche per ReleaseResaleAuthorization le azioni in. AWS Marketplace Catalog API Le convalide vengono eseguite quando si chiama. StartChangeSet Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.

Errori asincroni

Gli errori seguenti sono specifici ReleaseResaleAuthorization delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori dettagli sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.

Descrivere un'autorizzazione di rivendita esistente

Per descrivere i dettagli dell'autorizzazione alla rivendita, chiama l'operazione DescribeEntity API con il tipo di ResaleAuthorization@1.0 entità, come mostrato nell'esempio seguente.

Sintassi della richiesta

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

Fornisci informazioni per i campi per aggiungere il tipo di DescribeEntity modifica:

Sintassi della risposta

La risposta a questa richiesta fornisce i dettagli dell'offerta e ha il seguente aspetto.

{
  "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"
      }
    ]
  }
}

Di seguito sono riportate le informazioni sui campi visualizzati nella DescribeEntity risposta.