L'AWS Marketplace API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[AWS Marketplace API Reference](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
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 offerte private utilizzando il Marketplace AWS API
Puoi utilizzarlo AWS Marketplace Catalog API per automatizzare le attività relative all'utilizzo delle offerte.
Mentre il *prodotto* descrive ciò che viene venduto Marketplace AWS, l'*offerta* descrive i termini e le regole di acquisto e consumo del prodotto. Marketplace AWS i prodotti possono avere più offerte vendute da venditori diversi. Tuttavia, ogni Marketplace AWS offerta può essere creata per un solo prodotto. Un'*offerta* contiene una raccolta di termini contrattuali tra due parti. I termini dell'offerta accettati vengono tradotti in un accordo come prova di una transazione.
Esistono due tipi di offerte:
+ Le **offerte private** consentono a venditori e acquirenti di negoziare i prezzi. I venditori firmano un contratto di licenza con l'utente finale (EULA) per gli acquisti di software in. Marketplace AWS Un'offerta è visibile solo a un determinato acquirente. Per maggiori informazioni, consulta la sezione [Offerte private](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-overview.html) nella *Guida al Marketplace AWS venditore*.
+ Le **offerte pubbliche** riguardano programmi di acquisto globali. I venditori identificano i clienti in base ai programmi disponibili e alle aree geografiche, il che rende l'offerta accessibile solo a clienti specifici.
Consulta le seguenti risorse:
+ Per esempi di codice funzionanti, consulta [Gestire le offerte con l'API](https://catalog.workshops.aws/mpseller/en-US/manage-offers-with-api) nel *workshop per i Marketplace AWS venditori*.
+ Per esempi di codice di richiesta API, consulta Esempi in [Python](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/python/src/catalog_api/offers) e [Java](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java/resources/changeSets/offers) in *AWS Samples* on. GitHub
+ Per un video sulla creazione di offerte private, vedi [Creare un'offerta privata utilizzando l'API Marketplace AWS Catalog](https://www.youtube.com/watch?v=Gg9JR0tB330) su YouTube.
+ Per un video sull'aggiornamento dei prezzi AMI, consulta [Aggiornare i prezzi dei prodotti AMI utilizzando l'API del Marketplace AWS catalogo](https://www.youtube.com/watch?v=AVIRlzHKEJw) su YouTube.
I seguenti argomenti descrivono come utilizzare l'API Catalog per creare e aggiornare le offerte:
**Topics**
+ [Crea un'offerta](#create-offer)
+ [Crea un'offerta sostitutiva](#create-replacement-offer)
+ [Aggiorna le informazioni sull'offerta](#update-offer-information)
+ [Aggiorna la configurazione del targeting](#update-targeting-offers)
+ [Aggiorna la politica di rimborso](#update-support-terms)
+ [Aggiorna le risorse legali](#update-legal-terms)
+ [Aggiorna i prezzi](#update-pricing-terms)
+ [Aggiorna la reperibilità dell'offerta](#update-availability)
+ [Definire la data di scadenza degli accordi creati utilizzando l'offerta](#update-validity-terms)
+ [Aggiorna i dettagli del piano di pagamento](#update-payment-schedule-terms)
+ [Modifica le opzioni di rinnovo](#update-renewal-terms)
+ [Pubblica un'offerta](#release-offer)
+ [Descrivi i dettagli dell'offerta esistente](#describe-entity)
## Crea un'offerta
Puoi utilizzare l'API Catalog per creare una nuova offerta in Marketplace AWS. Se la richiesta viene elaborata correttamente`Draft`, AWS Marketplace Catalog API crea un'offerta incompleta e invisibile agli acquirenti. Per completare un'offerta, utilizza il tipo di `Update` modifica. Quando l'offerta è completa, utilizza il tipo di [`ReleaseOffer`](#release-offer)modifica per crearla e rilasciarla. Il rilascio di un'offerta la convalida e la rende visibile agli acquirenti. Marketplace AWS
Per creare una nuova offerta, richiama l'operazione `StartChangeSet` API con il tipo di `CreateOffer` modifica, come illustrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test Offer",
"OfferSetId": "offerset-b3f9EXAMPLE27"
}
}
]
}
```
Fornisci informazioni sui campi per aggiungere il tipo di `CreateOffer` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **ProductId**(string) (obbligatorio) — L'identificatore univoco del prodotto offerto.
+ **Nome** (stringa) (opzionale): il nome associato all'offerta per una migliore leggibilità per te e i tuoi clienti. Viene visualizzato anche come parte delle informazioni del Contratto.
+ **OfferSetId**(stringa) (opzionale): l'ID dell'offerta impostato a cui associare questa offerta. Specificate questo campo solo quando create un'offerta che farà parte di un set di offerte. Se non OfferSetId viene fornito, verrà creata un'offerta individuale che può essere acquistata separatamente. Tieni presente che l'indicazione di un OfferSetId durante la creazione dell'offerta indica solo l'intenzione di associare l'offerta a quel set di offerte. Per completare l'associazione, è necessario [utilizzare il tipo di AssociateOffers modifica](work-with-offer-sets.md#associate-offers) dopo la creazione dell'offerta.
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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 Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
Se lo `Status` è`SUCCEEDED`, ne `OfferId` viene generato uno nuovo.
La risposta avrà il seguente aspetto.
```
{
"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": "CreateOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test Offer"
},
"ErrorDetailList": []
}
]
}
```
**Convalide sincrone**
Le convalide dello schema seguenti sono specifiche per `CreateOffer` 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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| ProductId | Richiesto
La lunghezza deve essere compresa tra 1 e 50 caratteri
Non deve contenere caratteri non validi (\\, <, >) | 422 |
| ProductId | RichiestoL'utente deve essere autorizzato a creare un'offerta per il prodotto specifico | 403 |
| ProductId | RichiestoDeve essere un prodotto esistente nel catalogo o creato nello stesso set di modifiche | 404 |
| Nome | Facoltativo
La lunghezza deve essere compresa tra 1 e 150 caratteri
Non deve contenere caratteri non validi (\\, <, >) | 422 |
**Errori asincroni**
I seguenti errori sono specifici `CreateOffer` 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](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| PRODOTTO\_INCOMPATIBILE | Usa un prodotto attivo nel nostro stato. Limited Public |
| PRODOTTO\_INCOMPATIBILE | La gestione delle offerte per il tipo di prodotto scelto non è attualmente supportata in. AWS Marketplace Catalog API |
| PRODOTTO\_INCOMPATIBILE | La gestione delle offerte per il prodotto non è attualmente supportata in. AWS Marketplace Catalog API |
| PRODOTTO\_INCOMPATIBILE | OfferSetId non è supportato nelle offerte relative al prodotto. |
| PRODOTTO\_INCOMPATIBILE | CreateOffer il tipo di modifica non può essere richiamato per creare un'offerta per il prodotto. Usa il tipo CreateOfferUsingResaleAuthorization di modifica. |
## Crea un'offerta sostitutiva
Puoi utilizzare l'API Catalog per creare un'offerta sostitutiva (nota anche come offerta basata su contratto) in. Marketplace AWS
Se la tua richiesta è stata elaborata con successo, ti AWS Marketplace Catalog API verrà generata `Draft` un'offerta in corso, che è un'offerta incompleta e non visibile agli acquirenti su. Marketplace AWS Utilizzerai i tipi di `Update` modifica per completare l'offerta. Una volta completata l'offerta, utilizzerai la [`ReleaseOffer`](#release-offer)modifica del tipo per completare il processo di creazione dell'offerta e rilasciare l'offerta, che convaliderà l'intera offerta e la renderà visibile agli acquirenti su Marketplace AWS. Da quel momento, l'acquirente ha la possibilità di accettare l'offerta sostitutiva o di continuare a operare in base al contratto originale.
Per creare un'offerta sostitutiva, chiama l'operatore `StartChangeSet` API con il tipo di `CreateReplacementOffer` modifica e fornisci un ID di accordo preesistente, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateReplacementOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"AgreementId": "agmt-12345",
"Name": "Offer name"
}
}
]
}
```
Fornisci informazioni per i campi in cui aggiungere il tipo di `CreateReplacementOffer` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **AgreementId**(string) (obbligatorio) — L'identificatore univoco per l'accordo corrente da sostituire.
+ **Nome** (stringa) (opzionale): il nome associato all'offerta per una migliore leggibilità per te e i tuoi clienti. Verrà visualizzato anche come parte delle informazioni sull'Accordo.
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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 Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Convalide sincrone**
Le convalide dello schema seguenti sono specifiche per `CreateReplacementOffer` 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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| AgreementId | RichiestoLa lunghezza deve essere compresa tra 1 e 64 caratteri | 422 |
| AgreementId | RichiestoL'utente deve essere autorizzato a creare un'offerta per il contratto in questione | 403 |
| Nome | FacoltativoLa lunghezza deve essere compresa tra 1 e 150 caratteri
Non deve contenere caratteri non validi (\\, <, >) | 422 |
**Errori asincroni**
I seguenti errori sono specifici `CreateReplacementOffer` 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](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| PRODOTTO\_INCOMPATIBILE | Le offerte sostitutive non sono supportate per il prodotto. |
| ACCORDO\_INCOMPATIBILE | CreateReplacementOffer il tipo di modifica non può essere richiamato per creare un'offerta sostitutiva per l'accordo. Usa il tipo CreateReplacementOfferUsingResaleAuthorization di modifica. |
## Aggiorna le informazioni sull'offerta
Puoi utilizzare l'API Catalog per aggiornare le informazioni sull'offerta in Marketplace AWS.
Per aggiornare le informazioni sull'offerta, richiama l'operazione `StartChangeSet` API con il tipo di `UpdateInformation` modifica, come mostrato nell'esempio seguente. Tutte le altre informazioni rimarranno invariate.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Name": "New offer name",
"Description": "New offer description",
"PreExistingAgreement": {
"AcquisitionChannel": "External",
"PricingModel": "Contract"
}
}
}
]
}
```
Fornisci informazioni per i campi in cui aggiungere il tipo di `UpdateInformation` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **Nome** (stringa) (opzionale): nome associato all'offerta per una migliore leggibilità. Viene visualizzato come parte delle informazioni sull'accordo.
+ **Descrizione** (stringa) (opzionale): testo in formato libero pensato per essere utilizzato solo da te e che non sarà mai visibile agli acquirenti.
+ **PreExistingAgreement**(oggetto) (opzionale): determina se questa offerta è un rinnovo di un contratto esistente con un cliente esistente per lo stesso prodotto sottostante. L'accordo esistente può essere interno o esterno Marketplace AWS. AWS può controllare e verificare che la tua offerta sia un rinnovo. Se non AWS è in grado di verificare l'offerta, AWS può revocare l'offerta e concedere al cliente i relativi diritti.
+ **AcquisitionChannel**(stringa) (obbligatorio): indica se l'accordo esistente è stato firmato all'esterno o all'interno. Marketplace AWS Marketplace AWS
Valori possibili: `External`, `AwsMarketplace`
+ **PricingModel**(stringa) (obbligatorio): indica il modello di prezzo utilizzato dall'accordo esistente.
Valori possibili: `Contract`, `Usage`, `Byol`, `Free`
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Convalide sincrone**
Le convalide dello schema seguenti sono specifiche per `UpdateInformation` 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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| Properties | È necessario fornire almeno una delle seguenti proprietà | 422 |
| Nome | Facoltativo
La lunghezza deve essere compresa tra 1 e 150 caratteri
Non deve contenere caratteri non validi (\\, <, >) | 422 |
| Description | Facoltativo
La lunghezza deve essere compresa tra 1 e 255 caratteri | 422 |
| PreExistingAgreement | FacoltativoLa rimozione `PreExistingAgreement` dall'offerta può essere nullo | 422 |
| PreExistingAgreement.PricingModel | Richiesto
Può essere uno dei seguenti valori: [`Byol`,, `Free``Usage`,`Contract`] | 422 |
| PreExistingAgreement.AcquisitionChannel | Richiesto
Può essere uno di questi valori: [`AwsMarketplace`,`External`] | 422 |
**Errori asincroni**
I seguenti errori 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](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| ACCORDO\_PRE\_ESISTENTE INCOMPATIBILE | PreExistingAgreement non può essere modificato dopo il rilascio dell'offerta. |
## Aggiorna la configurazione del targeting
Puoi utilizzare l'API Catalog per aggiornare la configurazione del targeting della tua offerta in. Marketplace AWS
Tutte le opzioni di targeting esistenti che non sono incluse nell'ultima richiesta e verranno rimosse dall'offerta.
**Nota**
Un'offerta può facoltativamente includere `PositiveTargeting` o`NegativeTargeting`, ma non entrambi.
**Opzioni di targeting positivo:**
**Solo codici nazionali**: crea un'offerta pubblica disponibile per gli acquirenti nei paesi specificati.
**Solo account acquirente**: crea un'offerta privata mirata a specifici account AWS.
**Codici nazionali e account acquirente**: crea un'offerta privata in cui gli account target possono accettare l'offerta solo se si trovano in uno dei paesi specificati.
**Opzioni di targeting negativo:**
**Codici nazionali**: esclude gli acquirenti dei paesi specificati. Questo crea un'offerta pubblica disponibile per tutti i paesi ad eccezione di quelli elencati.
Per aggiornare la configurazione di targeting della tua offerta, richiama l'operazione `StartChangeSet` 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": [
"111122223333"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
}
}
]
}
```
Fornisci informazioni per i campi in cui aggiungere il tipo di `UpdateTargeting` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **PositiveTargeting**(oggetto) (opzionale): il targeting positivo definisce i criteri che il profilo di qualsiasi acquirente deve soddisfare per poter accedere all'offerta. Questo campo è facoltativo, ma è necessario fornire almeno un'opzione di targeting quando questo campo è presente.
+ **CountryCodes**(matrice di stringhe) (opzionale): elenca come opzione per consentire il targeting in base al paese. Se non si intende indirizzare l'offerta a un paese, questo campo deve essere omesso. Se è presente, l'elenco deve contenere almeno un prefisso internazionale. Ogni elemento di questo elenco deve essere un codice paese di 2 lettere valido, utilizzando questo formato: ISO 3166-1 alpha-2.
+ **BuyerAccounts**(matrice di stringhe) (opzionale): elenca come opzione per consentire il targeting basato su Account AWS (nota anche come offerta privata). Se l'intenzione è quella di non indirizzare l'offerta a un destinatario Account AWS, questo campo deve essere omesso.
+ **NegativeTargeting**(oggetto) (opzionale): il targeting negativo definisce i criteri che il profilo di qualsiasi cliente deve soddisfare per poter accedere all'offerta con restrizioni. Sebbene questo campo sia facoltativo, dovrebbe essere fornita almeno un'opzione di targeting quando questo campo è presente.
+ **CountryCodes**(matrice di stringhe) (obbligatorio): elenca come opzione per consentire il targeting in base al paese. Se non si intende indirizzare l'offerta a un paese specifico, questo campo deve essere omesso. Se è presente, l'elenco deve contenere almeno un prefisso internazionale. Ogni elemento di questo elenco deve essere un codice paese di 2 lettere valido utilizzando questo formato: ISO 3166-1 alpha-2.
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| NegativeTargeting | Facoltativo
Può avere una delle seguenti opzioni: [] `CountryCodes` | 422 |
| NegativeTargeting.CountryCodes | Facoltativo
La dimensione dell'elenco deve essere compresa tra 1 e 244
I codici dei paesi devono essere validi (ISO 3166-1 alpha-2) | 422 |
| PositiveTargeting | Facoltativo
Può avere una delle seguenti caratteristiche: [,] `CountryCodes` `BuyerAccounts` | 422 |
| PositiveTargeting.BuyerAccounts | Facoltativo
La dimensione dell'elenco deve essere compresa tra 1 e 26
Account AWS Gli ID devono essere in formato valido (numero a 12 cifre) | 422 |
| PositiveTargeting.CountryCodes | Facoltativo
La dimensione dell'elenco deve essere compresa tra 1 e 244
I codici dei paesi devono essere validi (ISO 3166-1 alpha-2) | 422 |
**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, vedere[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_BUYER\_ACCOUNTS | Fornisci account acquirente validi. Account non validi: [x]. |
| CODICI\_PAESE\_NON VALIDI | Fornisci i codici dei paesi supportati. |
| INVALID\_TARGETING | Utilizza il targeting negativo o positivo sullo stesso attributo. |
| PRODOTTO\_INCOMPATIBILE | Country-based il targeting non è supportato per il prodotto. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Purché siano compatibili con. BuyerAccounts ResaleAuthorization |
| INCOMPATIBLE\_TARGETING | La modifica richiesta non può essere eseguita dopo il rilascio dell'offerta. |
| INCOMPATIBLE\_TARGETING | La modifica richiesta non può essere eseguita dopo la scadenza dell'offerta. |
| INCOMPATIBLE\_TARGETING | Il targeting non può essere aggiornato su un'offerta sostitutiva. Se l'acquirente non è associato all'offerta fornita AgreementId, crea una nuova offerta privata fornendone una AgreementId associata all'acquirente. |
| TOO\_MANY\_BUYER\_ACCOUNTS | Fornire entro i limiti consentiti. BuyerAccounts |
| INCOMPATIBLE\_TARGETING | BuyerAccounts non può essere rimosso dopo il rilascio dell'offerta. |
| INCOMPATIBLE\_TARGETING | BuyerAccounts non può essere aggiunto dopo il rilascio dell'offerta. |
| MISSING\_COUNTRY\_CODES | Fornire PositiveTargeting con CountryCodes: [x]. |
| CODE\_COUNTRY\_INCOMPATIBILI | Purché siano compatibili. CountryCodes |
| INCOMPATIBLE\_BUYER\_ACCOUNTS | Purché siano compatibili con l'accordo. BuyerAccounts |
## Aggiorna la politica di rimborso
Puoi utilizzare l'API Catalog per aggiornare la politica di rimborso della tua offerta in Marketplace AWS.
Questa modifica non influisce sugli accordi esistenti. I termini di assistenza che non sono inclusi nell'ultima richiesta verranno rimossi dall'offerta.
Per aggiornare la politica di rimborso, chiama l'operatore `StartChangeSet` API con il tipo di `UpdateSupportTerms` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
}
]
}
```
Fornisci informazioni per i campi in cui aggiungere il tipo di `UpdateSupportTerms` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **Termini** (matrice di strutture) (obbligatorio): elenco dei termini di supporto che desideri aggiornare. I termini di supporto accettati sono:
+ **SupportTerm**(oggetto) (obbligatorio): definisce l'assistenza clienti disponibile per gli accettatori al momento dell'acquisto del software.
+ **Tipo** (stringa) (obbligatorio): tipo di termine da aggiornare. Questo è il valore dell'oggetto:`"SupportTerm"`.
+ **RefundPolicy**(stringa) (obbligatorio): Free-text campo relativo alla descrizione della politica di rimborso che verrà mostrata ai clienti così com'è sul sito Web e sulla console.
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Convalide sincrone**
Le convalide dello schema seguenti sono specifiche per `UpdateSupportTerms` 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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| Termini | Richiesto | 422 |
| Termini []. RefundPolicy | Richiesto
La lunghezza deve essere compresa tra 1 e 500
Non può iniziare o terminare con spazi | 422 |
| Termini [] .Tipo | RichiestoPuò solo essere `SupportTerm` | 422 |
**Errori asincroni**
I seguenti errori sono specifici `UpdateSupportTerms` 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](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| PRODOTTO\_INCOMPATIBILE | SupportTerm non è supportato nelle offerte private per il prodotto. |
| TERMINI\_INCOMPATIBILI | SupportTerm non è supportato per le offerte di prova gratuite. |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo il rilascio dell'offerta. |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo la scadenza dell'offerta. |
## Aggiorna le risorse legali
Puoi utilizzare l'API Catalog per sostituire i documenti legali esistenti, come un contratto di licenza con l'utente finale (EULA). I termini legali che non sono inclusi nell'ultima richiesta verranno rimossi dall'offerta.
Per aggiornare le risorse 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 in cui aggiungere il tipo di `UpdateLegalTerms` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **LegalTerm**(oggetto) (obbligatorio): definisce l'elenco degli accordi di testo da proporre agli accettatori. Un esempio di tale accordo è il contratto di licenza con l'utente finale (EULA).
+ **Tipo** (stringa) (obbligatorio): tipo di termine da aggiornare. Questo è il valore dell'oggetto:`"LegalTerm"`.
+ **Documenti** (serie di strutture) (obbligatorio) - Elenco di riferimenti alle risorse legali da proporre agli acquirenti. Un esempio di tale risorsa è il contratto di licenza con l'utente finale (EULA). Ogni riferimento è composto da a `Type` e a`URL`:
+ **Tipo** (stringa) (obbligatorio): tipo di documento. I tipi di documento disponibili sono:
+ **CustomEula**— Un EULA personalizzato fornito da te come venditore. Per questo tipo di [documento è necessario un URL S3 pubblico o un URL predefinito](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html).
+ **StandardEula**— Contratto standard per Marketplace AWS (SCMP). Per ulteriori informazioni su SCMP, consulta la Marketplace AWS Seller Guide. Non fornisci un URL per questo tipo perché è gestito da Marketplace AWS.
+ **Url** (stringa) (obbligatorio in base a determinate condizioni): un URL del documento legale che gli acquirenti possono leggere. Obbligatorio quando `Type` è uno dei seguenti [`CustomEula`].
+ **Versione** (stringa) (obbligatoria a determinate condizioni) — Versione dei contratti standard fornita da Marketplace AWS. Richiesto quando `Type` è [`StandardEula`]. Versione disponibile:
+ **14/07/2022 — Questa** versione del contratto standard per Marketplace AWS è disponibile da questo bucket Amazon S3: [https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf](https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf)
**Sintassi di risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| Termini | Richiesto
`LegalTerm`È consentito solo nell'elenco
La dimensione dell'elenco deve essere 1 | 422 |
| Termini [] .Tipo | RichiestoPuò solo essere `LegalTerm` | 422 |
| Termini []. LegalTerm.Documents | Richiesto | 422 |
| Termini []. LegalTerm.Documents[] .Tipo | Richiesto
Valori consentiti:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/marketplace/latest/developerguide/work-with-private-offers.html) | 422 |
| Termini []. LegalTerm.Documents[] .Url | Obbligatorio e deve essere un URL valido quando è Type CustomEula | 422 |
| Termini []. LegalTerm.Documents[] .Versione | Obbligatoria e deve essere una versione valida quando è TypeStandardEula`StandardEula`Versioni valide: ["2019-04-24", «2022-07-14"] | 422 |
**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, vedere[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo il rilascio dell'offerta. |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo la scadenza dell'offerta. |
| DOCUMENTI\_LEGALI\_NON VALIDI | Fornisci gli URL per i documenti legali archiviati in bucket S3 accessibili. |
| DOCUMENTI\_LEGALI\_NON VALIDI | Per le nuove offerte è supportata solo la versione più recente di. StandardEula |
| DOCUMENTI\_LEGALI\_NON VALIDI | Fornisci documenti legali nei formati di file supportati. |
| DOCUMENTI\_LEGALI\_NON VALIDI | Fornisci documenti legali utilizzando i tipi di documenti supportati. |
| LIMIT\_EXCEEDED\_LEGAL\_DOCUMENT\_SIZE | Fornisci documenti legali entro i limiti di dimensione consentiti. |
| DOCUMENTI\_LEGALI\_NON VALIDI | LegalTerm contiene documenti protetti da password. Fornisci documenti accessibili in. LegalTerm |
| DOCUMENTI\_LEGALI\_NON VALIDI | LegalTerm contiene documenti PDF non validi. Fornisci documenti accessibili in LegalTerm. |
## 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.
Per aggiornare i termini di prezzo della tua offerta, chiama l'operatore `StartChangeSet` API con il tipo di `UpdatePricingTerms` modifica, come mostrato nell'esempio seguente.
**Nota**
La seguente sintassi di richiesta combina diversi esempi. Questa combinazione non funziona come payload valido. Ad esempio, un `Terms` array non può includere sia il tipo di termine che `FixedUpfrontPricingTerm` il tipo di `ConfigurableUpfrontPricingTerm` termine. Per esempi di come vengono combinati diversi tipi di termini per diversi casi d'uso relativi ai prezzi, consulta [Gestire le offerte con l'API](https://catalog.workshops.aws/mpseller/en-US/manage-offers-with-api) nel *workshop dedicato ai Marketplace AWS venditori*.
**Nota**
Per i prodotti SaaS con modello di prezzo gratuito, è necessario includere una `UsageBasedPricingTerm` o `ConfigurableUpfrontPricingTerm` più RateCard (dimensioni) in cui tutti i prezzi siano fissati a 0,00 USD. Questo requisito è unico per i prodotti SaaS.
**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"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "300"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "ByolPricingTerm"
},
{
"Type": "RecurringPaymentTerm",
"CurrencyCode": "USD",
"BillingPeriod": "Monthly",
"Price": "100.0"
},
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "200.00",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "m3.xlarge",
"MaxQuantity": 10
},
{
"DimensionKey": "m4.xlarge",
"MaxQuantity": 10
}
]
}
]
}
}
]
}
```
Fornisci informazioni per i campi in cui aggiungere il tipo di `UpdatePricingTerms` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **PricingModel**(string) (richiesto): modello di prezzo per l'offerta. I valori possibili per il modello di prezzo sono:
+ **Utilizzo**: modello di Usage-based prezzo in base al quale agli acquirenti verrà fatturato l'utilizzo del prodotto.
+ **Contratto**: modello di Contract-based prezzo in cui agli acquirenti viene fatturato in anticipo l'utilizzo del prodotto o viene offerto un piano di pagamento flessibile. Gli acquirenti possono anche pagare per un utilizzo aggiuntivo rispetto al contratto.
+ **Gratuito**: modello di prezzo gratuito in cui agli acquirenti non verrà addebitato alcun costo per l'utilizzo del prodotto. Quando si utilizza questo modello di prezzo, nessun termine di prezzo o termine di pianificazione dei pagamenti può avere tassi diversi da zero.
+ **Byol**: modello di prezzo Byol in cui gli acquirenti porteranno la propria licenza per l'utilizzo del prodotto.
+ **Termini** (serie di strutture) (obbligatorio): elenco dei termini di prezzo che desideri aggiornare. Le condizioni di prezzo supportate sono:
+ **FreeTrialPricingTerm**(oggetto): definisce un modello di prezzo gratuito a breve termine in cui agli acquirenti non viene addebitato nulla entro un limite specificato.
+ **Tipo** (stringa): tipo di termine da aggiornare. Questo è il valore dell'oggetto:`"FreeTrialPricingTerm"`.
+ **Durata** (stringa): durata del periodo di prova gratuito.
+ **Sovvenzioni** (serie di strutture): diritti che verranno concessi all'accettante di una prova gratuita come parte dell'esecuzione di un contratto.
+ **DimensionKey**(stringa) — Chiave di dimensione univoca definita nel documento del prodotto. Le dimensioni rappresentano le categorie di capacità di un prodotto e vengono specificate quando il prodotto è elencato in Marketplace AWS.
+ **MaxQuantity**(numero intero) (opzionale): quantità massima di capacità che l'acquirente può avere per una determinata dimensione del prodotto. Se non `MaxQuantity` viene fornito, l'acquirente potrà utilizzare una quantità illimitata della dimensione specificata.
+ **UsageBasedPricingTerm**(oggetto): definisce un modello di prezzo pay-as-you-go (PAYG) in cui i clienti vengono addebitati in base all'utilizzo del prodotto.
+ **Tipo** (stringa) (obbligatorio): categoria del termine da aggiornare. Questo è il valore dell'oggetto:`UsageBasedPricingTerm`.
+ **CurrencyCode**(stringa) — Definisce la valuta per i prezzi indicati in questo termine. Attualmente, è supportato solo il dollaro statunitense.
+ **RateCards**(serie di strutture) — Elenco delle schede tariffarie.
+ **RateCard**(matrice di strutture): una scheda tariffaria definisce le tariffe unitarie per le dimensioni del prodotto.
+ **DimensionKey**(stringa) — Dimensione a cui si applica l'autorizzazione specificata. Le dimensioni rappresentano le categorie di capacità di un prodotto e vengono specificate quando il prodotto è elencato in. Marketplace AWS
+ **Prezzo** (stringa): Per-unit prezzo per la dimensione del prodotto che verrà utilizzato per calcolare l'importo da addebitare all'acquirente.
+ **ConfigurableUpfrontPricingTerm**(oggetto): definisce il modello di pagamento prepagato che consente agli acquirenti di configurare i diritti che desiderano acquistare e la durata dei diritti. Puoi aggiornare l'elenco delle tariffe per ogni durata del contratto e dei diritti per ogni dimensione.
+ **Tipo** (stringa) (obbligatorio): tipo di termine da aggiornare. Questo è il valore dell'oggetto:`ConfigurableUpfrontPricingTerm`.
+ **CurrencyCode**(stringa) (obbligatorio) — Definisce la valuta per i prezzi indicati in questo termine. Per le offerte pubbliche, sono supportati solo USD. Per le offerte private, sono supportati USD, AUD, EUR, GBP e JPY.
+ **RateCards**(serie di strutture) (obbligatorio) — Elenco delle schede tariffarie.
+ **Selettore** (oggetto) (obbligatorio): il selettore viene utilizzato per distinguere tra le schede tariffarie che si escludono a vicenda nello stesso periodo di determinazione del prezzo, che devono essere selezionate dall'acquirente.
+ **Tipo** (stringa) (obbligatorio) — Categoria del selettore. Al momento, `Duration` è supportato solo.
+ **Valore** (stringa) (obbligatorio): durata del contratto. Questo campo supporta il formato ISO 8601.
+ **RateCard**(matrice di strutture) (obbligatorio): una scheda tariffaria definisce le tariffe unitarie per le dimensioni del prodotto.
+ **DimensionKey**(stringa) (obbligatorio) — Chiave di dimensione univoca definita nel documento del prodotto. Le dimensioni rappresentano le categorie di capacità di un prodotto e vengono specificate quando il prodotto è elencato in Marketplace AWS.
+ **Prezzo** (stringa) (obbligatorio): Per-unit prezzo per la dimensione del prodotto che verrà utilizzato per calcolare l'importo da addebitare all'acquirente.
+ **Vincoli** (oggetto) (obbligatorio): definisce i vincoli su come il termine può essere configurato dagli accettatori.
**Nota**
Attualmente, i **QuantityConfiguration**valori devono essere **MultipleDimensionSelection**gli stessi.
+ **MultipleDimensionSelection**(stringa) (obbligatorio): determina se gli acquirenti possono selezionare più dimensioni nella tabella tariffaria. I valori possibili sono `Allowed` e `Disallowed`.
+ **QuantityConfiguration**(stringa) (obbligatorio): determina se gli accettatori sono autorizzati a configurare la quantità per ciascuna dimensione nella tabella tariffaria. I valori possibili sono `Allowed` e `Disallowed`.
+ **ByolPricingTerm**(oggetto): consente a te e ai tuoi clienti di trasferire Marketplace AWS gli accordi esistenti. Al cliente non verrà addebitato alcun costo per l'utilizzo del prodotto Marketplace AWS perché ha già pagato il prodotto al di fuori di Marketplace AWS.
+ **Tipo** (stringa) (obbligatorio): tipo di termine da aggiornare. Questo è il valore dell'oggetto:`ByolPricingTerm`.
+ **RecurringPaymentTerm**(oggetto): definisce un modello di prezzo in cui ai clienti viene addebitato un prezzo ricorrente fisso alla fine di ogni periodo di fatturazione.
+ **Tipo** (stringa) (obbligatorio): tipo di termine da aggiornare. Questo è il valore dell'oggetto:`RecurringPaymentTerm`.
+ **BillingPeriod**(string) (obbligatorio): definisce la ricorrenza in base alla quale viene addebitato l'importo agli acquirenti. `Monthly`È supportato solo oggi.
+ **Prezzo** (stringa) (obbligatorio): importo addebitato all'acquirente per ogni periodo di fatturazione.
+ **CurrencyCode**(stringa) (obbligatorio) — Definisce la valuta per i prezzi indicati in questo termine. Attualmente è supportato solo `USD`.
+ **FixedUpfrontPricingTerm**(oggetto): definisce un modello di prezzo prepagato in cui ai clienti viene addebitato un importo anticipato fisso.
+ **Tipo** (stringa) (obbligatorio): tipo di termine da aggiornare. Questo è il valore dell'oggetto:`FixedUpfrontPricingTerm`.
+ **CurrencyCode**(stringa) (obbligatorio) — Definisce la valuta per i prezzi indicati in questo termine. Per le offerte pubbliche, sono supportati solo USD. Per le offerte private, sono supportati USD, AUD, EUR, GBP e JPY.
+ **Prezzo** (stringa) (obbligatorio): importo fisso da addebitare al cliente quando questo termine viene accettato.
+ **Sovvenzioni** (serie di strutture) (obbligatorio): diritti che verranno concessi all'accettante di Fixed Upfront come parte dell'esecuzione del contratto.
+ **DimensionKey**(stringa) (obbligatorio) — Chiave di dimensione univoca definita nel documento del prodotto. Le dimensioni rappresentano le categorie di capacità di un prodotto e vengono specificate quando il prodotto è elencato in Marketplace AWS.
+ **MaxQuantity**(numero intero) (obbligatorio): quantità massima di capacità che l'acquirente può avere per una determinata dimensione del prodotto. Se non `MaxQuantity` viene fornita, l'acquirente potrà utilizzare una quantità illimitata della dimensione specificata.
+ **Durata** (stringa) (opzionale): definisce la durata in cui il termine rimane attivo. Questo campo supporta il formato ISO 8601.
**Sintassi di risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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.
| Campo di input | Regola di convalida | HTTP |
| --- | --- | --- |
| PricingModel | RichiestoModelli di prezzo consentiti: ["Byol», «Free», «Usage», «Contract"] | 422 |
| Termini | RichiestoTermini consentiti: [» ConfigurableUpfrontPricingTerm «," ByolPricingTerm «," FreeTrialPricingTerm «," UsageBasedPricingTerm «," RecurringPaymentTerm «] FixedUpfrontPricingTerm | 422 |
| Termini []. ByolPricingTerm | Richiesto | 422 |
| Termini []. ByolPricingTerm.Type | RichiestoPuò essere solo "ByolPricingTerm» | 422 |
| Termini []. ConfigurableUpfrontPricingTerm | Richiesto | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.Type | RichiestoPuò essere solo "ConfigurableUpfrontPricingTerm» | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.CurrencyCode | RichiestoValute supportate: ["USD», «AUD», «EUR», «GBP», «JPN"] | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards | RichiestoLa dimensione dell'elenco deve essere compresa tra 1 e 5 | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[] .Vincoli | Richiesto | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[]. Contraints.MultipleDimensionSelection | RichiestoValori consentiti: ["Consentito», «Non consentito"] | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[]. Contraints.QuantityConfiguration | RichiestoValori consentiti: ["Consentito», «Non consentito"] | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard | RichiestoLa dimensione dell'elenco deve essere compresa tra 1 e 800 | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard[]. DimensionKey | RichiestoLa lunghezza deve essere compresa tra 1 e 100 | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard[] .Prezzo | RichiestoIl tipo di dati è «String»
Non-negativedecimali con un massimo di 3 cifre decimali supportate | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[] .Selettore | Richiesto | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[]. Selector.Type | RichiestoValori consentiti: ["Durata"] | 422 |
| Termini []. ConfigurableUpfrontPricingTerm.RateCards[]. Selector.Value | RichiestoFormato previsto per tipo di selettore: durata ISO 8601 | 422 |
| Termini []. FixedUpfrontPricingTerm | Richiesto | 422 |
| Termini []. FixedUpfrontPricingTerm.Type | RichiestoPuò essere solo "FixedUpfrontPricingTerm» | 422 |
| Termini []. FixedUpfrontPricingTerm.CurrencyCode | RichiestoValute supportate: ["USD», «AUD», «EUR», «GBP», «JPN"] | 422 |
| Termini []. FixedUpfrontPricingTerm.Duration | RichiestoFormato previsto per tipo di selettore: durata ISO 8601 | 422 |
| Termini []. FixedUpfrontPricingTerm.Grants | RichiestoLa dimensione dell'elenco deve essere compresa tra 1 e 200 | 422 |
| Termini []. FixedUpfrontPricingTerm.Grants[]. DimensionKey | RichiestoLa lunghezza deve essere compresa tra 1 e 100 | 422 |
| Termini []. FixedUpfrontPricingTerm.Grants[]. MaxQuantity | RequiredValue deve essere maggiore di 0 | 422 |
| Termini []. FixedUpfrontPricingTerm.Price | RichiestoIl tipo di dati è «String»
Non-negativedecimali con un massimo di 3 cifre decimali supportate | 422 |
| Termini []. FreeTrialPricingTerm | Richiesto | 422 |
| Termini []. FreeTrialPricingTerm.Type | RichiestoPuò essere solo "FreeTrialPricingTerm» | 422 |
| Termini []. FreeTrialPricingTerm.Duration | RichiestoFormato previsto: durata ISO 8601 | 422 |
| Termini []. FreeTrialPricingTerm.Grants | RichiestoLa dimensione dell'elenco deve essere compresa tra 1 e 800 | 422 |
| Termini []. FreeTrialPricingTerm.Grants[]. DimensionKey | RichiestoLa lunghezza deve essere compresa tra 1 e 100 | 422 |
| Termini []. FreeTrialPricingTerm.Grants[]. MaxQuantity | FacoltativoIl valore deve essere maggiore di 0 | 422 |
| Termini []. RecurringPaymentTerm | Richiesto | 422 |
| Termini []. RecurringPaymentTerm.Type | RichiestoPuò essere solo "RecurringPaymentTerm» | 422 |
| Termini []. RecurringPaymentTerm.BillingPeriod | RichiestoValori consentiti: ["Monthly"] | 422 |
| Termini []. RecurringPaymentTerm.CurrencyCode | RichiestoValute supportate: ["USD"] | 422 |
| Termini []. RecurringPaymentTerm.Price | RichiestoIl tipo di dati è «String»
Non-negativedecimali con un massimo di 3 cifre decimali supportate | 422 |
| Termini []. UsageBasedPricingTerm | Richiesto | 422 |
| Termini []. UsageBasedPricingTerm.Type | RichiestoPuò essere solo "UsagedBasedPricingTerm» | 422 |
| Termini []. UsageBasedPricingTerm.CurrencyCode | RichiestoValute supportate: ["USD"] | 422 |
| Termini []. UsageBasedPricingTerm.RateCards | RichiestoDeve avere la dimensione di 1 | 422 |
| Termini []. UsageBasedPricingTerm.RateCards[]. RateCard | RichiestoLa dimensione dell'elenco deve essere compresa tra 1 e 800 | 422 |
| Termini []. UsageBasedPricingTerm.RateCards[]. RateCard[]. DimensionKey | RichiestoLa lunghezza deve essere compresa tra 1 e 100 | 422 |
| Termini []. UsageBasedPricingTerm.RateCards[]. RateCard[] .Prezzo | RichiestoIl tipo di dati è «String»
Non-negativedecimali con un massimo di 8 cifre decimali supportate | 422 |
**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, vedere[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| DUPLICATE\_DIMENSION\_KEYS | Fornisci a Grants un elenco univoco di chiavi di dimensione in [x]. |
| CHIAVI\_DIMENSIONALI\_DUPLICATE | Fornisci RateCard un elenco univoco di chiavi di dimensione in [x]. |
| SELETTORI DUPLICATI | Fornisci un elenco univoco di selettori in. ConfigurableUpfrontPricingTerm |
| DUPLICATE\_TERM\_TYPES | Fornisci un elenco univoco di tipi di termini. |
| ACCORDO\_INCOMPATIBILE | I seguenti termini non possono essere rimossi dall'offerta sostitutiva: [x, y, z]. |
| ACCORDO\_INCOMPATIBILE | I seguenti termini non possono essere aggiunti all'offerta sostitutiva: [x, y, z]. |
| CODICE\_VALUTA INCOMPATIBILE | CurrencyCode non può essere modificato dopo il rilascio dell'offerta. |
| IMPOSTAZIONI DI PAGAMENTO INCOMPATIBILI | Aggiorna le impostazioni di pagamento per renderle compatibili con. CurrencyCode |
| PRODOTTO\_INCOMPATIBILE | Il modello di prezzo d'uso non è supportato per il prodotto. |
| PRODOTTO\_INCOMPATIBILE | Il modello di prezzo contrattuale non è supportato per il prodotto. |
| PRODOTTO\_INCOMPATIBILE | Il modello di prezzo Byol non è supportato per il prodotto. |
| PRODOTTO\_INCOMPATIBILE | Il modello di prezzo gratuito non è supportato per il prodotto. |
| PRODOTTO\_INCOMPATIBILE | [x] non è supportato in un'offerta per il prodotto. |
| PRODOTTO\_INCOMPATIBILE | I termini di pagamento e di prezzo forniti sono incompatibili. |
| PRODOTTO\_INCOMPATIBILE | Usa le dimensioni esistenti e disponibili nel prodotto in [x]. |
| PRODOTTO\_INCOMPATIBILE | FreeTrialPricingTerm poiché l'unico termine di prezzo dell'offerta non è supportato per il prodotto. |
| PRODOTTO\_INCOMPATIBILE | I seguenti termini non sono supportati per il prodotto: [x, y, z]. |
| PRODOTTO\_INCOMPATIBILE | Le offerte sostitutive sono supportate solo per il modello di prezzo contrattuale. |
| PRODOTTO\_INCOMPATIBILE | Fornisci termini di prezzo compatibili con le dimensioni del prodotto. Condizioni di prezzo incompatibili: [x, y, z]. |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Imposta e attiva il modello tariffario Allowed in for usage. MultipleDimensionSelection QuantityConfiguration ConfigurableUpfrontPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Imposta e seleziona Non consentito nel modello di prezzo basato sull'utilizzo. MultipleDimensionSelection QuantityConfiguration ConfigurableUpfrontPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | QuantityConfiguration non può essere modificato dopo il rilascio dell'offerta. ConfigurableUpfrontPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | MultipleDimensionSelection non può essere modificato dopo il rilascio dell'offerta. ConfigurableUpfrontPricingTerm |
| TARIFFE\_INCOMPATIBILI | Imposta tutti gli importi e i prezzi degli addebiti su zero (0) quando utilizzi il modello di prezzo gratuito. |
| TARIFFE\_INCOMPATIBILI | Per un'offerta di prova gratuita del prodotto sono consentiti solo prezzi pari UsageBasedPricingTerm a zero (0). |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Fornire lo stesso specificato in. CurrencyCode ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Garantire la durata delle partite, la durata specificata in. FixedUpfrontPricingTerm ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Fornisci termini compatibili con. ResaleAuthorization Termini incompatibili: [x, y, z]. |
| DURATURA\_SELETTORE\_INCOMPATIBILE | Le durate non possono essere rimosse dalle schede tariffarie dopo il rilascio dell'offerta. ConfigurableUpfrontPricingTerm |
| VERIFICA\_VENDITORE\_INCOMPATIBILE | Completa tutti i processi di verifica del venditore richiesti. |
| TERMINI INCOMPATIBILI | [x] non è supportato insieme ai seguenti termini: [y, z]. |
| TERMINI\_INCOMPATIBILI | I seguenti termini non possono essere aggiunti dopo il rilascio dell'offerta: [x, y, z]. |
| TERMINI\_INCOMPATIBILI | I seguenti termini non possono essere rimossi dopo il rilascio dell'offerta: [x, y, z]. |
| TERMINI\_INCOMPATIBILI | [x] non è supportato per le offerte private. |
| TERMINI\_INCOMPATIBILI | I seguenti termini non sono supportati e FreeTrialPricingTerm garantiscono un utilizzo illimitato: [x, y, z]. |
| TERMINI\_INCOMPATIBILI | I seguenti termini non sono supportati FreeTrialPricingTerm per il prodotto: [x, y, z]. |
| TERMINI\_INCOMPATIBILI | Fornisci un prezzo pari a zero (0) per i casi in FixedUpfrontPricingTerm cui l'offerta contiene un. PaymentScheduleTerm |
| TERMINI\_INCOMPATIBILI | I seguenti termini non sono compatibili con PricingModel: [x, y, z]. |
| TERMINI\_INCOMPATIBILI | FixedUpfrontPricingTerm non è supportato quando MarkupPercentage è maggiore di zero (0). |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo il rilascio dell'offerta. |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo la scadenza dell'offerta. |
| DURATA NON VALIDA DEL CONTRATTO | Fornisci una durata compresa tra [x] e [y] mesi. |
| DURATA\_DI\_CONTRATTO\_NON VALIDA | Assicurati che la granularità della durata sia pari a quella giornaliera per le dimensioni misurate. |
| CODICE\_VALUTA NON VALIDO | Fornisci un file supportato. CurrencyCode |
| INVALID\_CURRENCY\_CODE | Fornisci lo stesso per tutti i prezzi e i termini di pagamento CurrencyCode . |
| INVALID\_CURRENCY\_CODE | Fornisci un file supportato. CurrencyCode |
| INVALID\_CURRENCY\_CODE | Fornisci lo stesso per tutti i prezzi e i termini di pagamento CurrencyCode . |
| INVALID\_DURATION | Assicurati che la durata in FreeTrialPricingTerm rientri nell'intervallo consentito. |
| INVALID\_DURATION | Specificare la durata in FixedUpfrontPricingTerm modo che corrisponda alla durata compresa tra e. AgreementStartDate AgreementEndDate |
| INVALID\_DURATION | Fornisci una durata compresa tra [x] e [y] mesi. |
| DURATURA\_INVALIDA | Assicurati che la granularità della durata sia a livello giornaliero per le dimensioni misurate. |
| INVALID\_GRANTS | Fornisci lo stesso MaxQuantity per tutte le sovvenzioni in. FreeTrialPricingTerm |
| INVALID\_GRANTS | Fornisci sovvenzioni per tutte le dimensioni misurate disponibili in. FreeTrialPricingTerm |
| INVALID\_GRANTS | The combination of Dimensions in grants is invalid in FixedUpfrontPricingTerm for the product. |
| SOVVENZIONI NON VALIDE | The combination of Dimensions in grants is invalid in FreeTrialPricingTerm for the product. |
| SOVVENZIONI NON VALIDE | FixedUpfrontPricingTerm with MaxQuantity is not supported for this product. |
| CAMBIA\_DI\_PREZZO NON VALIDA | [x] non può essere aggiornato fino a [y] perché hai richiesto un aumento di prezzo negli ultimi 120 giorni. Per annullare la precedente richiesta di aumento del prezzo o per ulteriori informazioni, contatta il team di Marketplace AWS Managed Catalog Operations. |
| INVALID\_PRICE\_CHANGE | L'aumento di prezzo e l'aggiunta di dimensioni in [x] non sono supportati nella stessa richiesta. Aggiungi prima le dimensioni. |
| INVALID\_PRICE\_CHANGE | L'aumento e la diminuzione del prezzo UsageBasedPricingTerm non sono supportati nella stessa richiesta. Diminuisci prima i prezzi. |
| INVALID\_PRICE\_CHANGE | L'aumento RecurringPaymentTerm e la diminuzione del prezzo in UsageBasedPricingTerm non sono supportati nella stessa richiesta. Diminuisci prima i prezzi. |
| INVALID\_PRICE\_CHANGE | La riduzione RecurringPaymentTerm e l'aumento del prezzo UsageBasedPricingTerm non sono supportati nella stessa richiesta. Diminuisci prima i prezzi. |
| INVALID\_RATE\_CARD | ConfigurableUpfrontPricingTerm manca una o più chiavi dimensionali per la durata [x]. Fornisci i prezzi per lo stesso set di chiavi di dimensione per tutte le durate. |
| INVALID\_RATE\_CARD | Fornisci un tariffario solo per le dimensioni misurate in. UsageBasedPricingTerm |
| INVALID\_RATE\_CARD | Le tariffe non possono essere rimosse da [x]. Specificate i prezzi per tutte le dimensioni nella scheda tariffaria esistente. |
| INVALID\_RATE\_CARD | Fornisci dimensioni che abbiano la stessa unità in [x]. |
| INVALID\_RATE\_CARD | Fornisci tutte le dimensioni misurate o tutte le dimensioni autorizzate in [x]. |
| INVALID\_RATE\_CARD | Fornisci solo le dimensioni autorizzate in [x]. |
| INVALID\_RATE\_CARD | Fornisci tariffe basate sull'utilizzo per tutte le dimensioni misurate disponibili in. UsageBasedPricingTerm |
| INVALID\_RATE\_CARD | Fornisci tariffe basate sull'utilizzo per tutte le dimensioni della prova gratuita. |
| INVALID\_RATE\_CARD | Fornisci prezzi con un massimo di 8 cifre decimali. UsageBasedPricingTerm |
| INVALID\_RATE\_CARD | The combination of Dimensions in rate card is invalid in UsageBasedPricingTerm for the product. |
| VALORE\_DI\_SELETTORE\_DURATA\_NON VALIDO | Fornisci una durata compresa tra [x] e [y] mesi. |
| VALORE\_SELETTORE\_DURATA\_NON VALIDO | Assicurati che la granularità della durata sia pari a quella giornaliera per le dimensioni misurate. |
| VALORE\_SELETTORE\_DURATION\_NON VALIDO | Assicurati che la durata in rientri nell'intervallo consentito. ConfigurableUpfrontPricingTerm |
| VALORE\_SELETTORE\_DURATA NON VALIDO | Fornisci una o più durate contrattuali supportate. |
| VALORE\_SELETTORE\_DURATA NON VALIDO | Fornisci una o più durate contrattuali supportate o un'unica durata personalizzata. |
| VALORE\_SELETTORE\_DURATIVO\_NON VALIDO | Specificare la durata in modo che corrisponda alla durata compresa tra e. ConfigurableUpfrontPricingTerm AgreementStartDate AgreementEndDate |
| MISSING\_DURATION | Fornisci la durata in. FixedUpfrontPricingTerm |
| MISSING\_MANDATORY\_TERMS | FixedUpfrontPricingTerm è supportato solo se abbinato a o. ByolPricingTerm PaymentScheduleTerm |
| MISSING\_MANDATORY\_TERMS | Fornisci almeno uno dei [x, y, z]. |
| TERMINI\_OBBLIGATORI MANCANTI | Fornisci un modello di prezzo quando usi Byol. ByolPricingTerm |
| TOO\_MANY\_GRANTS | Fornisci fino a [x] sovvenzioni in [y]. |
| TOO\_MANY\_RATE\_CARDS | È consentita una sola carta tariffaria per il prodotto. ConfigurableUpfrontPricingTerm |
| TOO\_MANY\_RATE\_CARDS | Per il prodotto sono consentite fino a [x] schede tariffarie. ConfigurableUpfrontPricingTerm |
| TOO\_MANY\_RATES | Fornire RateCards entro i limiti consentiti in. ConfigurableUpfrontPricingTerm |
| TOO\_MANY\_RATES | Fornire RateCards entro i limiti consentiti in. UsageBasedPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Imposta entrambi MultipleDimensionSelection e QuantityConfiguration sullo stesso valore (Consentito o Non consentito) in. ConfigurableUpfrontPricingTerm |
| INCOMPATIBLE\_RATE\_CARD\_CONSTRAINTS | Fornisci gli stessi vincoli per tutte le carte tariffarie in. ConfigurableUpfrontPricingTerm |
| INVALID\_UPDATE\_REQUEST | [x] non può essere aggiornato. Per richiedere una modifica dei prezzi o per ulteriori informazioni, contatta il team di Marketplace AWS Managed Catalog Operations. |
| MODELLO\_PREZZO\_INCOMPATIBILE | PricingModel non può cambiare da [x] a [y]. |
| INVALID\_GRANTS | MaxQuantity for the FreeTrialPricingTerm è limitato al prodotto. Fornisci un valore MaxQuantity inferiore o uguale a [x]. Per ulteriori informazioni, contatta il Marketplace AWS Managed Catalog Operations Team. |
| INVALID\_GRANTS | Fornisci tutte le MaxQuantity sovvenzioni in. FixedUpfrontPricingTerm |
| INVALID\_GRANTS | MaxQuantity non è supportato nel FixedUpfrontPricingTerm prodotto. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Garantisci le sovvenzioni nelle corrispondenze specificate in. FixedUpfrontPricingTerm RateCards ResaleAuthorization |
## Aggiorna la reperibilità dell'offerta
Puoi utilizzare l'API Catalog per controllare la reperibilità della tua offerta in. Marketplace AWS
Puoi scegliere di impostare una data specifica nel futuro per limitare la visibilità della tua offerta o nel passato per far scadere l'offerta. Il tipo di `UpdateAvailability` modifica non influisce sugli accordi esistenti.
**Nota**
Puoi utilizzare il tipo di `UpdateAvailability` modifica su un'offerta privata che è già stata [pubblicata](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (nota anche come *rilasciata*). Se gli acquirenti hanno già accettato l'offerta privata, gli accordi esistenti non sono interessati.
Quando si modifica un'offerta privata esistente, è necessario rispettare i [vincoli della durata dell'accordo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-validity-terms). `AvailabilityEndDate` In caso contrario, includi un tipo di `UpdateValidityTerms` modifica aggiuntivo in questo set di modifiche per modificare la durata del contratto in modo da rispettare la nuova scadenza. Il tipo di `UpdateValidityTerms` modifica può essere utilizzato su un'offerta privata rilasciata o non ancora rilasciata.
Quando si modifica un'offerta privata esistente, è necessario rispettare i [vincoli del piano di pagamento](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-payment-schedule-terms). `AvailabilityEndDate` Se non lo è e l'offerta privata *non è ancora stata rilasciata*, includi un tipo di `UpdatePaymentScheduleTerms` modifica aggiuntivo in questo set di modifiche per modificare il piano di pagamento in modo che rispetti la nuova scadenza. Se l'offerta privata è *già stata rilasciata*, puoi apportare modifiche solo se `AvailabilityEndDate` la nuova data rispetta i vincoli del piano di pagamento.
Per controllare la rilevabilità 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:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **AvailabilityEndDate**(stringa) (obbligatorio): questa è la data fino alla data in cui l'offerta è rilevabile e acquistabile in. Marketplace AWS Puoi scegliere di impostare una data specifica nel futuro per limitare la disponibilità o nel passato per far scadere l'offerta. Le date sono rappresentate in `YYYY-MM-DD` formato.
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ID e l'ARN per il set di modifiche ed è simile alla seguente.
**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. Include la convalida delle informazioni per garantire che soddisfino le linee guida. Marketplace AWS Il processo di convalida può richiedere alcuni minuti. Puoi controllare lo stato della richiesta tramite o nell'API Catalog con l'`DescribeChangeSet`azione. Portale di gestione Marketplace AWS
**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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| AvailabilityEndDate | Richiesto
Formato: "» YYYY-MM-DD | 422 |
**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 dettagli sull'utilizzo `DescribeChangeSet` per ottenere lo stato di una richiesta di modifica, consulta[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_AVAILABILITY\_END\_DATE | AvailabilityEndDate non è supportato per le offerte pubbliche. |
| INVALID\_AVAILABILITY\_END\_DATE | Offri un futuro AvailabilityEndDate. |
| INVALID\_AVAILABILITY\_END\_DATE | Fornisci qualcosa che è precedente. AvailabilityEndDate AgreementEndDate |
| DATA\_DI\_DISPONIBILITÀ\_FINE MANCANTE | Fornisci un codice antecedente alla data di AvailabilityEndDate fine del contratto. |
## Definire la data di scadenza degli accordi creati utilizzando l'offerta
Puoi utilizzare l'API Catalog per definire i dettagli della data di scadenza degli accordi creati utilizzando l'offerta in Marketplace AWS.
Questo tipo di modifica non influisce sugli accordi esistenti.
**Nota**
Puoi utilizzare il tipo di `UpdateValidityTerms` modifica su un'offerta privata che è già stata [pubblicata](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (nota anche come *rilasciata*). Se gli acquirenti hanno già accettato l'offerta privata, gli accordi esistenti non sono interessati.
Per **AMI-based**i prodotti **basati su contenitori**, se le [condizioni di prezzo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-pricing-terms) dell'offerta privata includono un tipo di termine con un `Duration` (ad esempio, i tipi di termine `FixedUpfrontPricingTerm` o`ConfigurableUpfrontPricingTerm`), il tipo di modifica `AgreementDuration` impostato deve essere superiore al seguente: il numero di giorni compresi tra oggi e la [scadenza dell'offerta privata](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-availability) più il numero di giorni stabiliti tra tali tipi `Duration` di termine. Questo perché, dopo aver accettato l'offerta privata e creato l'accordo, un acquirente può facoltativamente acquistare i diritti aggiuntivi specificati in tali tipi di termini fino alla scadenza dell'offerta privata. Inoltre, tutti i diritti aggiuntivi devono scadere prima della scadenza del contratto. Ad esempio, se l'acquirente accetta l'offerta privata il primo giorno disponibile e poi acquista i diritti l'ultimo giorno disponibile, tali diritti non devono scadere dopo la data di fine del contratto.
Per definire i dettagli della data di scadenza degli accordi creati utilizzando l'offerta, chiama 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 sui campi in cui aggiungere il tipo di `UpdateValidityTerms` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **Termini** (matrice di strutture): elenco dei termini di validità che si desidera aggiornare. I termini di validità supportati sono:
+ **ValidityTerm**(oggetto): definisce le condizioni che manterranno valido un accordo creato a partire da questa offerta.
+ **Tipo** (stringa) — Categoria del termine da aggiornare. `ValidityTerm`
+ **AgreementDuration**(stringa) — Definisce per quanto tempo l'accordo rimane attivo. Se `AgreementStartDate` non viene fornita, la durata del contratto è relativa all'ora di firma dell'accordo. La durata è rappresentata nel formato ISO\_8601.
+ **AgreementStartDate**(stringa) — Definisce la data di inizio dell'accordo. `AgreementStartDate`è rappresentato in `YYYY-MM-DD` formato. L'accordo ha inizio alle 00:00:00.000 UTC della data fornita. Se `AgreementStartDate` non viene fornita, la data di inizio del contratto viene determinata in base all'ora di firma dell'accordo.
+ **AgreementEndDate**(stringa): definisce la data di scadenza dell'accordo. `AgreementEndDate`È rappresentato in `YYYY-MM-DD` formato. L'accordo termina alle 23:59:59.999 UTC della data indicata. Se `AgreementEndDate` non viene fornita, la data di fine del contratto è determinata dalla validità dei singoli termini.
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| Termini | Richiesto | 422 |
| Terms [] .Type | Richiesto
Può solo essere `"ValidityTerm"` | 422 |
| Termini []. AgreementDuration | Facoltativo
Formato previsto per tipo di selettore: durata ISO 8601
Può essere indipendente o abbinato a `AgreementStartDate` | 422 |
| Termini []. AgreementEndDate | Facoltativo
La data deve essere formattata come `"YYYY-MM-DD"` | 422 |
| Termini []. AgreementStartDate | Facoltativo
La data deve essere formattata come `"YYYY-MM-DD"`
Può essere abbinato solo a e `AgreementEndDate` `AgreementDuration` | 422 |
**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, vedere[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| ACCORDO\_INCOMPATIBILE | AgreementStartDate non può essere in futuro se l'attuale accordo da sostituire non ha una data futura. |
| DATA\_FINE\_CONTRATTO\_INCOMPATIBILE | AgreementEndDate non può essere aggiornato dopo il rilascio dell'offerta. |
| DATA\_INIZIO\_CONTRATTO\_INCOMPATIBILE | AgreementStartDate non può essere aggiornato dopo il rilascio dell'offerta. |
| PRODOTTO\_INCOMPATIBILE | AgreementStartDate in future non è supportata. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Assicurati che la durata compresa tra e sia compatibile con. AgreementStartDate AgreementEndDate ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Ensure è compatibile con. AgreementStartDate ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Ensure è compatibile con. AgreementEndDate ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Assicurati che la durata compresa tra e sia compatibile con. AgreementStartDate AgreementEndDate ResaleAuthorization |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Assicurati che la durata delle partite sia specificata in. AgreementDuration ResaleAuthorization |
| TERMINI INCOMPATIBILI | ValidityTerm non è supportato per le offerte pubbliche. |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo la scadenza dell'offerta. |
| DURATA NON VALIDA DEL CONTRATTO | Purché AgreementDuration sia maggiore o uguale a [x] giorni. |
| DATA\_DI\_FINE DELL'ACCORDO NON VALIDA | Offri un futuro AgreementEndDate. |
| DATA\_DI\_FINE DELL'ACCORDO NON VALIDA | Fornisci AgreementEndDate che sia successivo o uguale a [x]. |
| DATA\_INIZIO\_CONTRATTO\_NON VALIDA | Fornisci un nome che viene dopo. AgreementStartDate AvailabilityEndDate |
| DATA\_INIZIO\_CONTRATTO\_NON VALIDA | Fornisci un nome che precede il. AgreementStartDate AgreementEndDate |
| DATA\_INIZIO\_CONTRATTO\_NON VALIDA | Fornisci un documento entro [x] AgreementStartDate anni a partire da oggi. |
| INVALID\_AGREEMENT\_TEMPO\_INTERVAL | ValidityTerm con entrambi e non è supportato. AgreementDuration AgreementEndDate |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | ValidityTerm con entrambi AgreementStartDate e AgreementDuration non è supportato in un'offerta per il prodotto. |
| INVALID\_AGREEMENT\_TEMPO\_INTERVAL | ValidityTerm with AgreementStartDate non è supportato in un'offerta per il prodotto. |
| INVALID\_AGREEMENT\_TEMPO\_INTERVAL | ValidityTerm with only non è supportato. AgreementStartDate |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | AgreementEndDate non è supportato a meno che non venga utilizzato in combinazione con offerte future AgreementStartDate o sostitutive. |
| INVALID\_AGREEMENT\_TIME\_INTERVAL | Specificare AgreementStartDate e AgreementEndDate se la differenza è inferiore o uguale a [x] anni. |
| DATA\_DI\_INIZIO\_CONTRATTO\_MANCANTE | Ensure AgreementStartDate è presente in quando viene utilizzato insieme a. ValidityTerm ConfigurableUpfrontPricingTerm |
| DATA\_DI\_FINE DELL'ACCORDO NON VALIDA | Fornisci un documento entro [x] AgreementEndDate anni a partire da oggi. |
| DATA\_INIZIO\_CONTRATTO\_INCOMPATIBILE | Fornisci lo stesso AgreementStartDate come definito nell'accordo quando l'accordo ha date di inizio future. |
| ACCORDO\_INCOMPATIBILE | AgreementStartDate non può avere date future se l'accordo non ha una data futura. |
## Aggiorna i dettagli del piano di pagamento
Puoi utilizzare l'API Catalog per aggiornare i dettagli del piano di pagamento della tua offerta, ad esempio un programma di pagamento flessibile, in Marketplace AWS.
**Nota**
Non puoi utilizzare il tipo di `UpdatePaymentScheduleTerms` modifica su un'offerta che è già stata [pubblicata](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (nota anche come *rilasciata*).
L'offerta privata può essere accettata in qualsiasi giorno tra la creazione dell'offerta privata e la sua [scadenza](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-availability) (impostata nel`AvailabilityEndDate`). Un solo `ChargeDate` valore del piano di pagamento può essere la data corrispondente o precedente all'ultimo giorno in cui l'acquirente può accettare l'offerta privata (la data di scadenza dell'offerta privata). I valori rimanenti di `ChargeDate` devono essere indicati dopo la scadenza dell'offerta privata, ma non oltre la fine del contratto se l'offerta privata è stata accettata immediatamente. La fine del contratto si basa sul momento in cui l'offerta privata viene accettata (creazione dell'accordo) più la [durata del contratto](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-validity-terms).
Per aggiornare i dettagli del piano di pagamento per la tua offerta, chiama l'operazione `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 tipo di `UpdatePaymentScheduleTerms` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **Termini** (serie di strutture): elenco dei termini di pagamento che desideri aggiornare. I termini di pagamento supportati sono:
+ **PaymentScheduleTerm**(oggetto): definisce un modello tariffario rateale in cui ai clienti viene addebitato un prezzo fisso in date diverse durante il periodo di validità del contratto.
+ **Tipo** (stringa): tipo di termine da aggiornare. Questo è il valore dell'oggetto:`"PaymentScheduleTerm"`.
+ **Pianificazione** (matrice di strutture): elenco dello schema di pagamento in cui ogni elemento definisce una rata di pagamento. Contiene le informazioni necessarie per calcolare il prezzo da pagare e la data in cui verrebbe addebitato al cliente.
+ **ChargeDate**(stringa) — La data in cui il cliente pagherebbe il prezzo definito nel presente termine del piano di pagamento. `ChargeDate`è rappresentato in YYYY-MM-DD formato. Le fatture vengono generate alla data indicata.
+ **ChargeAmount**(stringa) — Il prezzo che il cliente pagherebbe alla data prevista (`ChargeDate`).
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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.
| Campo di input | Regola di convalida | HTTP |
| --- | --- | --- |
| Termini | Richiesto
`PaymentScheduleTerm`È consentito solo
La dimensione dell'elenco deve essere inferiore a 2 | 422 |
| Terms [] .Type | Richiesto
Può solo essere `PaymentScheduleTerm` | 422 |
| Termini []. PaymentScheduleTerm.CurrencyCode | Richiesto
Valute supportate: ["USD», «AUD», «EUR», «GBP», «JPY"] | 422 |
| Termini []. PaymentScheduleTerm.Schedule[] | Richiesto | 422 |
| Termini []. PaymentScheduleTerm.Schedule[]. ChargeAmount | RichiestoIl tipo di data è «Stringa»
Non-negativedecimali con un massimo di 2 cifre decimali supportate | 422 |
| Termini []. PaymentScheduleTerm.Schedule[]. ChargeDate | Richiesto
La data deve essere formattata come "» YYYY-MM-DD | 422 |
**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, vedere[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| DUPLICATE\_CHARGE\_DATES | Fornisci date di addebito uniche in. PaymentScheduleTerm |
| INCOMPATIBLE\_CURRENCY\_CODE | CurrencyCode non può essere modificato dopo il rilascio dell'offerta. |
| INCOMPATIBLE\_MARKUP\_PERCENTAGE | PaymentScheduleTerm non è supportato quando MarkupPercentage è maggiore di zero (0). |
| INCOMPATIBLE\_PAYMENT\_SETTINGS | Aggiorna le impostazioni di pagamento per renderle compatibili con. CurrencyCode |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Fornisci termini compatibili con. ResaleAuthorization Termini incompatibili: [PaymentScheduleTerm]. |
| INCOMPATIBLE\_RESALE\_AUTHORIZATION | Assicurati che il totale in sia compatibile con. ChargeAmounts PaymentScheduleTerm ResaleAuthorization |
| INCOMPATIBLE\_SELLER\_VERIFICATION | Completa tutti i processi di verifica del venditore richiesti. |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo il rilascio dell'offerta. |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo la scadenza dell'offerta. |
| INVALID\_CHARGE\_DATES | Fornisci le date di addebito precedenti. AgreementEndDate |
| INVALID\_CURRENCY\_CODE | Fornisci un file supportato. CurrencyCode |
| INVALID\_CURRENCY\_CODE | Fornisci lo stesso per tutti i prezzi e i termini di pagamento CurrencyCode . |
| TOO\_MANY\_BACKDATED\_CHARGES | Fornisci fino a 1 pagamento programmato in precedenza. AvailabilityEndDate |
| INVALID\_CHARGE\_DATES | Fornisci una data dell'ultimo addebito precedente. AgreementEndDate |
| INVALID\_CHARGE\_DATES | Fornisci una data di primo addebito che non sia passata. |
| TOO\_MANY\_CHARGES | Fornisci fino a [x] pagamenti programmati in. PaymentScheduleTerm |
## Modifica le opzioni di rinnovo
Puoi utilizzare l'API Catalog per controllare le opzioni di rinnovo degli accordi creati utilizzando questa offerta in Marketplace AWS.
Per le offerte create tramite l'API Catalog, il rinnovo automatico rimane disabilitato per impostazione predefinita finché non richiami il tipo di `UpdateRenewalTerms` modifica per consentire il rinnovo automatico. Questa modifica non influisce sugli accordi esistenti.
Per controllare le opzioni di rinnovo degli accordi creati utilizzando questa offerta, richiama l'operazione `StartChangeSet` API con il tipo di `UpdateRenewalTerms` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
}
]
}
```
Fornisci informazioni sui campi in cui aggiungere il tipo di `UpdateRenewalTerms` modifica:
+ **Entità** (oggetto) (obbligatorio): la tua offerta.
+ **Tipo** (stringa) (obbligatorio): `Type` è sempre`Offer@1.0`.
+ **Identificatore** (stringa) (obbligatorio): l'ID dell'offerta. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(object) (richiesto) — Il valore JSON delle specifiche della richiesta.
+ **Termini** (serie di strutture): elenco dei termini di rinnovo che desideri aggiornare. I termini di rinnovo supportati sono:
+ **RenewalTerm**(oggetto): definisce che in caso di risoluzione graduale (scadenza del contratto`ValidityTerm`, non dell'acquirente o Marketplace AWS annullamento), verrà creato un nuovo contratto utilizzando i termini accettati nell'accordo esistente. In altre parole, l'accordo verrà rinnovato. La presenza di `RenewalTerm` nell'offerta significa che è consentito il rinnovo automatico. Gli acquirenti avranno la possibilità di accettare o rifiutare il rinnovo automatico al momento della acceptance/agreement creazione dell'offerta.
+ **Tipo** (stringa): tipo di termine da aggiornare. `RenewalTerm`
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Convalide sincrone**
Le convalide dello schema seguenti sono specifiche per `UpdateRenewalTerms` 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.
| Campo di input | Regola di convalida | Codice HTTP |
| --- | --- | --- |
| Termini | Richiesto | 422 |
| Terms [] .Type | RichiestoPuò essere solo "» RenewalTerm | 422 |
**Errori asincroni**
I seguenti errori sono specifici `UpdateRenewalTerms` 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, consulta[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| PRODOTTO\_INCOMPATIBILE | RenewalTerm non è supportato nelle offerte private per il prodotto. |
| TERMINI\_INCOMPATIBILI | RenewalTerm non è supportato insieme a. PaymentScheduleTerm |
| TERMINI INCOMPATIBILI | RenewalTerm non è supportato con. PricingModel |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo il rilascio dell'offerta. |
| TERMINI INCOMPATIBILI | La modifica richiesta non può essere effettuata dopo la scadenza dell'offerta. |
## Pubblica un'offerta
Puoi utilizzare l'API Catalog per unire le informazioni raccolte da tutti i tipi di modifiche agli aggiornamenti e quindi pubblicare l'offerta.
Le offerte rimangono invariate fino `Draft` a quando non `ReleaseOffer` vengono richiamate. Dopo il rilascio dell'offerta, è possibile scoprirla 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 per i campi in cui aggiungere il tipo di `ReleaseOffer` modifica:
+ **Entità** (oggetto): il tipo denominato di entità che viene creata. `Identifier`Questo è l'ID della tua offerta e lo `Type` è sempre`Offer@1.0`. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **DetailsDocument**(oggetto) — Il valore JSON delle specifiche della richiesta. Deve essere vuoto per. `ReleaseOffer`
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`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. Marketplace AWS Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` 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.
| Campo di input | Regola di convalida |
| --- | --- |
| DetailsDocument | Deve essere vuota ({}) |
**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, vedere[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INCOMPATIBLE\_PAYMENT\_SETTINGS | Aggiorna le impostazioni di pagamento per renderle compatibili con. CurrencyCode |
| PRODOTTO\_INCOMPATIBILE | Per prima cosa crea un'offerta pubblica per il prodotto. |
| INCOMPATIBLE\_SELLER\_VERIFICATION | Completa tutti i processi di verifica del venditore richiesti. |
| INCOMPATIBLE\_TARGETING | PreExistingAgreement è supportato solo per le offerte mirate all'acquirente. |
| INCOMPATIBLE\_TARGETING | OfferSetId è supportato solo per le offerte mirate all'acquirente. |
| INFORMAZIONI\_FISCALI NON VALIDE | Le tue informazioni fiscali sono incomplete. Per vendere servizi professionali Marketplace AWS, devi completare il questionario fiscale DAC7. Vai alla sezione Informazioni di pagamento e seleziona il modulo fiscale DAC7. L'aggiornamento delle informazioni fiscali può richiedere fino a due ore. |
| INVALID\_UPDATE\_REQUEST | La modifica richiesta non può essere eseguita dopo il rilascio dell'offerta. |
| DATA\_DEL\_CONTRATTO\_MANCANTE | Fornisci un codice per le offerte sostitutive. AgreementEndDate |
| DATA\_DI\_DISPONIBILITÀ\_MANCANTE | Fornisci un'offerta privata. AvailabilityEndDate |
| MISSING\_BUYER\_ACCOUNTS | Fornisci per le offerte create utilizzando PositiveTargeting . BuyersAccounts ResaleAuthorization |
| MISSING\_BUYER\_ACCOUNTS | Tutte le offerte per il prodotto devono essere private. Fornire PositiveTargeting con BuyersAccounts. |
| DESCRIZIONE\_MANCANTE | Imposta la descrizione prima di rilasciare l'offerta. |
| MISSING\_MANDATORY\_TERMS | Aggiungi [x] all'offerta. |
| TERMINI\_OBBLIGATORI MANCANTI | Fornisci un quando l'offerta contiene un. FixedUpfrontPricingTerm PaymentScheduleTerm |
| NOME\_MANCANTE | Imposta il nome prima di rilasciare l'offerta. |
| TOO\_MANY\_OFFERS | È possibile creare una sola offerta di prova gratuita pubblica per prodotto. |
| TOO\_MANY\_OFFERS | È possibile creare una sola offerta pubblica per prodotto. |
| TERMINI\_OBBLIGATORI MANCANTI | Fornisci un elenco di offerte pubbliche con RenewalTerm prezzi contrattuali per il prodotto. |
| DATA\_DI\_FINE DELL'ACCORDO MANCANTE | Fornisci un codice per le offerte sostitutive. AgreementEndDate |
## Descrivi i dettagli dell'offerta esistente
Puoi utilizzare l'API Catalog per descrivere i dettagli dell'offerta esistente in Marketplace AWS.
Per descrivere i dettagli dell'offerta esistente, richiama l'operazione `DescribeEntity` API con il tipo di `Offer@1.0` entità, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
GET /DescribeEntity?catalog=&entityId= HTTP/1.1
```
Fornisci informazioni sui campi per aggiungere il tipo di `DescribeEntity` modifica:
+ **catalog** (string) — Il catalogo relativo alla richiesta. Valore fisso:`AWSMarketplace`.
+ **entityID** (string) — L'ID univoco dell'offerta da descrivere.
**Sintassi della risposta**
La risposta a questa richiesta fornisce i dettagli dell'offerta ed è simile alla seguente.
```
{
"EntityType": "Offer@1.0",
"EntityIdentifier": "offer-ad8EXAMPLE51@1",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/Offer/offer-ad8EXAMPLE51",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"DetailsDocument": {
"Id": "offer-3rEXAMPLErn",
"State": "Released",
"Name": "Test Offer",
"Description": "Worldwide offer for Test Product",
"PreExistingAgreement": {
"AcquisitionChannel": "External",
"PricingModel": "Contract"
},
"ProductId": "prod-ad8EXAMPLE51",
"OfferSetId": "offerset-b3f9EXAMPLE27",
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "If you need to request a refund for software sold by Amazon Web Services, LLC, please contact AWS Customer Service."
},
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "m3.xlarge",
"MaxQuantity": 10
},
{
"DimensionKey": "m4.xlarge",
"MaxQuantity": 10
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"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": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "200.00",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
},
{
"Type": "RecurringPaymentTerm",
"CurrencyCode": "USD",
"BillingPeriod": "Monthly",
"Price": "100.0"
},
{
"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"
}
]
},
{
"Type": "ByolPricingTerm"
},
{
"Type": "RenewalTerm"
}
],
"Rules": [
{
"Type": "TargetingRule",
"PositiveTargeting": {
"CountryCodes": [
"US",
"CA"
],
"BuyerAccounts": [
"444455556666"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
},
{
"Type": "AvailabilityRule",
"AvailabilityEndDate": "2024-08-30T01:56:03.000Z"
}
]
}
}
```
Di seguito sono riportate informazioni sui campi visualizzati nella `DescribeEntity` risposta.
+ **EntityType**(stringa) — Il tipo denominato dell'entità, che è`Offer@1.0`.
+ **EntityIdentifier**(stringa) — L'identificatore dell'entità, nel formato di`EntityId@RevisionId`.
+ **EntityArn**(stringa) — L'ARN associato all'identificatore univoco per il set di modifiche a cui si fa riferimento in questa richiesta.
+ **LastModifiedDate**(stringa) — La data dell'ultima modifica dell'entità, in formato ISO 8601 (ad esempio:). `2018-02-27T13:45:22Z`
+ **Dettagli** (stringa): questo oggetto JSON con stringhe include i seguenti dettagli dell'entità:
+ **Id** (stringa): identificatore univoco per un'entità dell'offerta in Marketplace AWS e generato durante la creazione di un'offerta.
+ **Stato** (stringa): lo stato dell'offerta.
+ **Nome** (stringa): il nome associato all'offerta per una migliore leggibilità per te e i tuoi clienti. Verrà visualizzato anche come parte delle informazioni sull'Accordo.
+ **Descrizione** (stringa): la descrizione è un testo in formato libero che deve essere utilizzato solo da te e non sarà mai esposto agli acquirenti.
+ **PreExistingAgreement**(stringa): determina se questa offerta è un rinnovo di un contratto esistente con un cliente esistente per lo stesso prodotto sottostante. L'accordo esistente può essere interno o esterno Marketplace AWS. AWS può controllare e verificare che la tua offerta sia un rinnovo. Se non AWS è in grado di verificare l'offerta, AWS può revocare l'offerta e concedere al cliente i relativi diritti.
+ **AcquisitionChannel**(stringa) — Indica se l'accordo esistente è stato firmato all'esterno o all'interno. Marketplace AWS Marketplace AWS Valori possibili:`External`,`AwsMarketplace`.
+ **PricingModel**(stringa): indica il modello di prezzo utilizzato dall'accordo esistente. Valori possibili:`Contract`,`Usage`,`Byol`,`Free`.
+ **ProductId**(stringa) — L'identificatore univoco del prodotto offerto.
+ **OfferSetId**(stringa) — L'identificatore univoco dell'offerta impostato a cui associare questa offerta.
+ **Termini** (serie di strutture): elenco di termini.
+ **Regole** (matrice di strutture): elenco di regole.