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à.

Collabora con le offerte private dei partner di canale utilizzando il AWS Marketplace API

Puoi utilizzarli AWS Marketplace Catalog API per automatizzare le attività per lavorare con le offerte private dei partner di canale (CPPO).

Quando crei o aggiorni un CPPO, la bozza di offerta conterrà i termini e le regole di un'autorizzazione alla rivendita e sarà invisibile all'acquirente. È possibile, ma non obbligatorio, coinvolgere più persone all'interno dell'organizzazione per creare un'offerta privata.

Ad esempio, una persona può essere responsabile dell'aggiornamento dei prezzi mentre una seconda persona può essere responsabile dell'aggiornamento della pianificazione dei pagamenti. Quindi, una terza persona può essere responsabile dell'aggiornamento dei termini legali. Puoi autorizzare una persona ad aggiornare alcune parti di un'offerta. Tuttavia, puoi concedere solo autorizzazioni di lettura alle autorizzazioni di rivendita.

Come prerequisito per chiamare i tipi di modifica, è necessario aver ricevuto una o più autorizzazioni di rivendita e avere dimestichezza con esse. AWS Marketplace Catalog API

Per ulteriori informazioni, consulta le offerte private dei partner di canale nella Guida per i AWS Marketplace venditori.

I seguenti argomenti descrivono come utilizzare l'API del catalogo per creare e aggiornare i CPPO:

Prerequisiti CPPO

Service-linked role for ResaleAuthorization (SLR) setup è un prerequisito obbligatorio per utilizzare l'autorizzazione di rivendita per creare un CPPO. 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 un CPPO

Utilizzi un'autorizzazione di rivendita dedicata a te per creare un'offerta privata per i partner di canale (CPPO) nello Draft stato del. AWS Marketplace

Se la tua richiesta viene elaborata con successo, AWS Marketplace Catalog API genera per te un'offerta nello Draft stato con i termini dell'autorizzazione alla rivendita. Puoi utilizzarlo DescribeEntity per visualizzare i termini applicati alla bozza di offerta contenuta nell'Autorizzazione alla rivendita. Si tratta di un'offerta incompleta e non visibile agli acquirenti in AWS Marketplace. Quindi utilizzi i tipi di modifica associati al CPPO per completare l'offerta.

Una volta completata l'offerta, utilizzi il tipo di ReleaseOffer modifica per completare il processo di creazione dell'offerta e rilasciarla. Ciò convaliderà l'intera offerta e renderà la tua offerta visibile agli acquirenti in AWS Marketplace.

Per creare un'offerta privata per i partner di canale, richiama l'operazione StartChangeSet API con il tipo di CreateOfferUsingResaleAuthorization modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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

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

Fornisci informazioni per i campi per aggiungere il tipo di CreateOfferUsingResaleAuthorization 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.

La risposta a questa richiesta fornisce lo stato della richiesta. Se lo stato èSUCCEEDED, ne OfferId viene generato uno nuovo.

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

Puoi utilizzare la GET DescribeEntity richiesta per descrivere la bozza delle regole e dei termini dell'offerta creata ResaleAuthorization nella AWS Marketplace Catalog API Referenza. Per ulteriori informazioni, consulta DescribeChangeSet.

Termini e regole di ResaleAuthorization

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

Convalide sincrone

Le seguenti convalide dello schema sono specifiche per CreateOfferUsingResaleAuthorization 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 CreateOfferUsingResaleAuthorization 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.

Crea un'offerta sostitutiva privata per i partner di canale

Puoi utilizzare l'API del catalogo per creare un'offerta sostitutiva privata per i partner di canale in AWS Marketplace.

Per creare un'offerta sostitutiva privata indicata nell'API del catalogo per i partner di canale, utilizzate l'offerta sostitutiva ResaleAuthorization mirata a voi e l'Accordo di cui siete il proponente, chiamando StartChangeSet con il tipo di CreateReplacementOfferUsingResaleAuthorization modifica, come mostrato nell'esempio seguente. Draft Le offerte sostitutive possono essere utilizzate per sostituire un accordo di un'offerta precedente prima che scada.

CreateReplacementOfferUsingResaleAuthorizationcreerà una bozza di offerta indirizzata all'accettatore del contratto. Questo targeting non può essere modificato in seguito. La bozza di offerta conterrà anche l'ID dell'offerta di origine dell'accordo.

Per creare un'offerta sostitutiva privata per i partner di canale, richiama l'operazione StartChangeSet API con il tipo di CreateReplacementOfferUsingResaleAuthorization modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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

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

Fornisci informazioni per i campi per aggiungere il tipo di CreateReplacementOfferUsingResaleAuthorization 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 e ha il seguente aspetto.

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

Convalide sincrone

Le seguenti convalide dello schema sono specifiche per CreateReplacementOfferUsingResaleAuthorization 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 CreateReplacementOfferUsingResaleAuthorization 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 markup

Puoi utilizzare l'API del catalogo per aggiornare i termini dei prezzi in base al valore percentuale della tua offerta in AWS Marketplace.

Ciò applicherà il markup percentuale specificato a tutti i termini di prezzo e di pagamento (per i piani di pagamento futuri) definiti dal produttore nel ResaleAuthorization. Qualsiasi markup esistente verrà sovrascritto. Puoi visualizzare prezzi e termini di pagamento aggiornati utilizzando. DescribeEntity

Per aggiornare il markup, richiama l'operazione StartChangeSet API con il tipo di UpdateMarkup modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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

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

Fornisci informazioni per i campi per aggiungere il tipo di UpdateMarkup 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 seguenti convalide dello schema sono specifiche per UpdateMarkup 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 UpdateMarkup 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 la configurazione del targeting

Puoi utilizzare l'API del catalogo per sostituire completamente la configurazione di targeting esistente in. AWS Marketplace

Tutte le opzioni di targeting esistenti non incluse nell'ultima richiesta verranno rimosse dall'offerta. I produttori possono menzionare acquirenti mirati specifici inResaleAuthorization. I partner di canale possono offrire offerte private a un sottoinsieme di acquirenti utilizzando PositiveTargeting il tipo di UpdateTargeting modifica.

Per aggiornare le configurazioni mirate della tua offerta, richiama l'operazione StartChangeSet API indicando il tipo di UpdateTargeting modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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

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

Fornisci informazioni per i campi per aggiungere il tipo di UpdateTargeting 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 UpdateTargeting 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 UpdateTargeting 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 unire i termini legali dell'autorizzazione alla rivendita e sostituire completamente i termini legali esistenti in. AWS Marketplace

Questa modifica non influisce sugli accordi esistenti. I termini legali non inclusi nell'ultima richiesta verranno rimossi dall'offerta. Puoi visualizzare i termini legali uniti DescribeEntity chiamando.

Per aggiornare i termini legali della tua offerta, chiama l'operazione StartChangeSet API con 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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "LegalTerm",
            "Documents": [
              {
                "Type": "CustomEula",
                "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

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

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce l'ID del set di modifiche.

Sintassi della risposta

{
"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 nell'API del catalogo con l'DescribeChangeSetazione. Portale di gestione AWS Marketplace

Convalide sincrone

Le seguenti convalide dello schema sono specifiche per UpdateLegalTerms 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 UpdateLegalTerms 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.

Aggiornare la rilevabilità del CPPO

Puoi utilizzare l'API del catalogo per gestire la rilevabilità della tua offerta in. AWS Marketplace Questo tipo di modifica non influisce sugli accordi esistenti.

Puoi scegliere di impostare una data specifica futura per limitare la reperibilità dell'offerta o nel passato per far scadere l'offerta.

Per gestire la rilevabilità della tua offerta, chiama 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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "AvailabilityEndDate": "2024-05-31"
      }
    }
  ]
}

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 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 UpdateAvailability 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 UpdateAvailability 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.

Definire la data di scadenza dei contratti

È possibile utilizzare l'API del catalogo per definire la data di scadenza degli accordi creati utilizzando questa offerta in AWS Marketplace.

Questa modifica non influisce sugli accordi esistenti. Il produttore potrebbe indicare la data massima di inizio del contratto in un'autorizzazione alla rivendita. Tuttavia, i partner di canale non possono fornire una data di inizio del contratto successiva a tale data.

Per definire la data di scadenza degli accordi, richiama l'operazione StartChangeSet API con il tipo di UpdateValidityTerms modifica, come mostrato nell'esempio seguente.

Sintassi della richiesta

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

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

Fornisci informazioni per i campi per aggiungere il tipo di UpdateValidityTerms 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 UpdateValidityTerms 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 UpdateValidityTerms 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 prezzi

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

Le condizioni tariffarie non incluse nell'ultima richiesta verranno rimosse dall'offerta. I partner di canale possono utilizzare questo tipo di modifica solo per passareFixedUpFrontPricingTerm.

Per aggiornare i termini di prezzo delle tue offerte, chiama 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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "Details": {
        "PricingModel": "Contract",
        "Terms": [
          {
            "Type": "FixedUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "Price": "200.00",
            "Duration": "P465D",
            "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 UpdatePricingTerms 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 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 i dettagli della pianificazione dei pagamenti

Puoi utilizzare l'API del catalogo per modificare i dettagli della pianificazione dei pagamenti, ad esempio la pianificazione flessibile dei pagamenti, in AWS Marketplace.

Se il produttore ha fornito un piano di pagamento in Resale Authorization, Channel Partner può:

Per aggiornare i dettagli associati ai pagamenti per la tua offerta, chiama 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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "PaymentScheduleTerm",
            "Schedule": [
              {
                "ChargeDate": "2021-12-01",
                "ChargeAmount": "200.00"
              },
              {
                "ChargeDate": "2022-03-01",
                "ChargeAmount": "250.00"
              }
            ]
          }
        ]
      }
    }
  ]
}

Fornisci informazioni per i campi per aggiungere il UpdatePaymentScheduleTerms tipo di 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 UpdatePaymentScheduleTerms 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 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, vedereUtilizzo dei set di modifiche.

Aggiornamento dei termini di pagamento netti

Se l'autorizzazione alla rivendita utilizzata per creare un'offerta privata per i partner di canale (CPPO) contiene un termine di pagamento netto, tale termine è il periodo massimo che puoi offrire all'acquirente. Il termine dell'autorizzazione alla rivendita viene applicato automaticamente al CPPO al momento della creazione.

Per offrire all'acquirente un periodo di pagamento più breve di quello autorizzato dal venditore, chiama l'operazione StartChangeSet API indicando il tipo di UpdateNetPaymentTerms modifica nell'offerta, come mostrato nell'esempio seguente. Se desideri utilizzare lo stesso periodo autorizzato dal venditore, non devi chiamareUpdateNetPaymentTerms.

Se l'autorizzazione alla rivendita non contiene un termine di pagamento netto, non puoi aggiungerne uno al CPPO e si applicano i termini di pagamento dell'acquirente. AWS Inoltre, non puoi rimuovere il termine di pagamento netto da un CPPO quando l'autorizzazione alla rivendita ne contiene uno.

Sintassi della richiesta

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

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

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

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

I seguenti errori sono specifici UpdateNetPaymentTerms delle azioni su un CPPO 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.

Pubblica il CPPO

Puoi utilizzare l'API del catalogo per unire le informazioni raccolte da tutti i tipi di modifiche all'aggiornamento e quindi pubblicare l'offerta in. AWS Marketplace

Le offerte rimangono in uno Draft stato finché non ReleaseOffer vengono richiamate. Dopo il rilascio, l'offerta è rilevabile in AWS Marketplace.

Per pubblicare la tua offerta, chiama l'operazione StartChangeSet API con il tipo di ReleaseOffer modifica come mostrato nell'esempio seguente.

Sintassi della richiesta

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

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

Fornisci informazioni per i campi per aggiungere il tipo di ReleaseOffer 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 ReleaseOffer 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 ReleaseOffer 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.

Definire un CPPO esistente

Puoi utilizzare l'API del catalogo per definire i dettagli del CPPO in. AWS Marketplace

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

Fornisci informazioni per i campi di input per la DescribeEntity risposta: