L'AWS Marketplace API Reference è 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 Marketplace AWS API

Puoi utilizzarle AWS Marketplace Catalog API per automatizzare le attività relative all'utilizzo delle 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 dell'organizzazione per creare un'offerta privata.

Ad esempio, una persona può essere responsabile dell'aggiornamento dei prezzi mentre un'altra persona può essere responsabile dell'aggiornamento del calendario 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 l'utilizzo. AWS Marketplace Catalog API

Per maggiori informazioni, consulta le offerte private dei partner di canale nella Guida al Marketplace AWS venditore.

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

Prerequisiti CPPO

Service-linked role for ResaleAuthorization (SLR) setup è un prerequisito obbligatorio per utilizzare l'autorizzazione alla rivendita per creare un CPPO. Per utilizzare l'autorizzazione alla rivendita, sia i fornitori di software indipendenti (ISV) che i partner di Marketplace AWS canale devono creare un ruolo collegato al servizio 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 dell'ISV con il Channel Partner. Marketplace AWS Per maggiori informazioni, consulta la sezione Utilizzo dei ruoli per l'autorizzazione alla rivendita Marketplace AWS nella Guida al Marketplace AWS venditore.

Crea un CPPO

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

Se la tua richiesta viene elaborata correttamente, AWS Marketplace Catalog API genera un'offerta valida per te con Draft i termini dell'autorizzazione alla rivendita. Puoi utilizzarlo DescribeEntity per visualizzare i termini applicati alla bozza di offerta di Resale Authorization. Questa è un'offerta incompleta e non è visibile agli acquirenti. Marketplace AWS Utilizza quindi 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 la renderà visibile agli acquirenti in Marketplace AWS.

Per creare un'offerta privata per i partner di canale, richiama l'operazione StartChangeSet API con il tipo di CreateOfferUsingResaleAuthorization modifica, come illustrato 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 sui campi per aggiungere il tipo di CreateOfferUsingResaleAuthorization modifica:

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

La risposta a questa richiesta indica 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 di regole e termini dell'offerta creata ResaleAuthorization nel AWS Marketplace Catalog API Riferimento. 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 convalide dello schema seguenti 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

I seguenti errori 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 Catalog per creare un'offerta sostitutiva privata per i partner di canale in Marketplace AWS.

Utilizza l'indirizzo ResaleAuthorization targetizzato a te e un accordo di cui sei il proponente per creare un'offerta sostitutiva privata per i partner di Draft canale disponibile nell'API Catalog chiamando StartChangeSet con il tipo di CreateReplacementOfferUsingResaleAuthorization modifica, come illustrato nell'esempio seguente. Le offerte sostitutive possono essere utilizzate per sostituire un contratto di un'offerta precedente prima della scadenza.

CreateReplacementOfferUsingResaleAuthorizationcreerà una bozza di offerta con l'accettatore dell'accordo come target. 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, richiamate l'operazione StartChangeSet API con il tipo di CreateReplacementOfferUsingResaleAuthorization modifica, come illustrato 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 sui campi per aggiungere il tipo di CreateReplacementOfferUsingResaleAuthorization modifica:

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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 Catalog per aggiornare i termini di prezzo in base a un valore percentuale della tua offerta in Marketplace AWS.

Verrà applicata la maggiorazione percentuale specificata 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 i prezzi e i termini di pagamento aggiornati utilizzando. DescribeEntity

Per aggiornare il markup, richiama l'operazione StartChangeSet API con il tipo di UpdateMarkup modifica, come illustrato 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 sui campi in cui aggiungere il tipo di UpdateMarkup modifica:

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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 Operativo del Marketplace AWS venditore per garantire che soddisfino le Marketplace AWS linee guida. 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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 Catalog per sostituire completamente la configurazione di targeting esistente in. Marketplace AWS

Tutte le opzioni di targeting esistenti che non sono 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 di targeting della tua offerta, richiama l'StartChangeSetoperatore API con 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 in cui aggiungere il tipo di UpdateTargeting modifica:

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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. Marketplace AWS 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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.

Aggiorna le risorse legali

Puoi utilizzare l'API Catalog per unire i termini legali di Resale Authorization e sostituire completamente i termini legali esistenti. Marketplace AWS

Questa modifica non influisce sugli accordi esistenti. I termini legali che non sono 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'StartChangeSetoperatore 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 in cui aggiungere il tipo di UpdateLegalTerms modifica:

Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce l'ID per il 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 Operativo del Marketplace AWS venditore per garantire che soddisfino le Marketplace AWS linee guida. Il processo di convalida può richiedere da pochi minuti a qualche ora. Puoi controllare lo stato della richiesta tramite o nell'API Catalog con l'DescribeChangeSetazione. Portale di gestione Marketplace AWS

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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.

Aggiorna la reperibilità del CPPO

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

Puoi scegliere di impostare una data specifica nel futuro per limitare la visibilità della tua offerta o nel passato per far scadere l'offerta.

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

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

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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. Marketplace AWS 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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 degli accordi

Puoi utilizzare l'API Catalog per definire la data di scadenza degli accordi creati utilizzando questa offerta in Marketplace AWS.

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 illustrato 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 sui campi per aggiungere il tipo di UpdateValidityTerms modifica:

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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. Marketplace AWS 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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 Catalog per sostituire completamente le condizioni tariffarie esistenti.

I termini di prezzo che non sono inclusi nell'ultima richiesta verranno rimossi 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'operatore dell'StartChangeSetAPI 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 sui campi per aggiungere il tipo di UpdatePricingTerms modifica:

Sintassi di risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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. Marketplace AWS 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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 del programma di pagamento

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

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

Per aggiornare i dettagli associati al pagamento della tua offerta, chiama l'operatore StartChangeSet API con 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 in cui aggiungere il UpdatePaymentScheduleTerms tipo di modifica:

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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. Marketplace AWS 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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.

Pubblica il CPPO

Puoi utilizzare l'API Catalog per unire le informazioni raccolte da tutti i tipi di modifiche agli aggiornamenti e quindi pubblicare l'offerta in. Marketplace AWS

Le offerte rimangono invariate fino Draft a quando non ReleaseOffer vengono richiamate. Una volta rilasciata, l'offerta è consultabile in Marketplace AWS.

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 sui campi in cui aggiungere il tipo di ReleaseOffer modifica:

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde 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. Marketplace AWS 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 Marketplace AWS l'API Catalog utilizzando l'operazione DescribeChangeSet API.

Convalide sincrone

Le convalide dello schema seguenti 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

I seguenti errori 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

È possibile utilizzare l'API Catalog per definire i dettagli del CPPO in. Marketplace AWS

Per definire un CPPO esistente, richiamate l'operazione DescribeEntity API con il tipo di Offer@1.0 entità, come illustrato nell'esempio seguente.

Sintassi della richiesta

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

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

Sintassi della risposta

La risposta a questa richiesta fornisce i dettagli dell'offerta ed è simile alla seguente.

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