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 set di offerte
I set di offerte di AWS Marketplace consentono ai venditori di raggruppare più offerte private in pacchetti transabili unificati multiprodotto per gli acquirenti. Questa funzionalità risponde alla crescente domanda dei clienti di soluzioni complete e end-to-end in ambienti aziendali complessi.
Tradizionalmente, gli acquirenti dovevano scoprire e acquistare singoli prodotti da più venditori, con il risultato di esperienze frammentate, sfide di integrazione e cicli di approvvigionamento più lunghi. I set di offerte semplificano questa situazione consentendo ai partner di AWS Marketplace di combinare più offerte insieme, semplificando il processo di transazione attraverso offerte private coordinate in cui i clienti possono esaminare e accettare tutti i componenti con un'unica approvazione.
I set di offerte collaborano con le soluzioni per fornire offerte complete per più prodotti. Le soluzioni forniscono ricchi contenuti di marketing, tra cui descrizioni dettagliate, diagrammi di architettura e documentazione dei casi d'uso, mentre i set di offerte gestiscono gli imballaggi negoziabili e i termini commerciali per l'approvvigionamento unificato.
## Entità del set di offerte
Un set di offerte è un contenitore che raggruppa 2-7 offerte private in un unico pacchetto negoziabile. Ogni offerta inclusa in un set di offerte mantiene prezzi, termini di pagamento, durata e contratto di licenza con l'utente finale (EULA) distinti, mentre il set di offerte offre un'esperienza di scoperta e accettazione unificata per gli acquirenti.
**Caratteristiche principali:**
+ Gruppi di offerte private (minimo 2, massimo 7)
+ Consente l'accettazione unificata da parte dell'acquirente di tutte le offerte con un'unica azione
+ Mantiene la flessibilità con termini distinti per ogni offerta
+ Crea accordi separati per ogni prodotto, permettendo una gestione indipendente dopo l'acquisto
+ Può essere associato opzionalmente a una soluzione per contenuti di marketing avanzati
Il tipo di entità del set di offerte è`OfferSet@1.0`.
**Identificatori di entità**
I set di offerte utilizzano il formato `offerset-*` identificativo (ad esempio,`offerset-abc123def456`).
**Formato ARN dell'entità**
I set di offerte seguono il formato AWS ARN standard:
```
arn:aws:aws-marketplace:{region}:{account-id}:AWSMarketplace/OfferSet/{offerset-id}
```
Esempio:
```
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-abc123def456
```
## Guida introduttiva ai set di offerte
Questa sezione fornisce informazioni dettagliate sulla creazione e la gestione dei set di offerte utilizzando i [tipi di modifica](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Change.html) dell'API del Marketplace AWS catalogo.
Prima di iniziare, assicurati di avere:
+ Registrazione valida del venditore AWS Marketplace e profilo pubblico. Per ulteriori informazioni, consulta [Registrati e crea il tuo profilo venditore](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html).
+ Accesso all'API e prerequisiti per il venditore completati. Per ulteriori informazioni, consulta [Controllo degli accessi per l'API AWS Marketplace Catalog](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html).
+ Hai appreso le nozioni di base sull'utilizzo dell'API AWS Marketplace Catalog, consulta [Uso dell'API AWS Marketplace Catalog](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html).
## Elenca i set di offerte
Per elencare tutti i set di offerte presenti nel tuo account, chiama l'operazione `ListEntities` API con `EntityType` set to`OfferSet`.
**Richiesta**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "OfferSet"
}
```
**Risposta**
```
{
"EntitySummaryList": [
{
"EntityType": "OfferSet",
"EntityId": "offerset-xyz123",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123",
"LastModifiedDate": "2025-06-25T23:46:25Z",
"OfferSetSummary": {
"Name": "Enterprise Security Solution Offer Set",
"State": "Released",
"ReleaseDate": "2025-06-25T23:46:20Z",
"SolutionId": "soln-abc987",
"AssociatedOfferIds": [
"offer-abc123",
"offer-def456",
"offer-ghi789"
]
}
}
],
"NextToken": null
}
```
### Filtra i set di offerte per stato
Puoi filtrare i set di offerte per stato utilizzando il `EntityTypeFilters` parametro.
**Richiesta**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "OfferSet",
"EntityTypeFilters": {
"OfferSetFilters": {
"State": {
"ValueList": [
"Released"
]
}
}
}
}
```
### Filtra i set di offerte per ID della soluzione
Puoi filtrare i set di offerte in base all'ID della soluzione utilizzando il `EntityTypeFilters` parametro.
**Richiesta**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "OfferSet",
"EntityTypeFilters": {
"OfferSetFilters": {
"SolutionId": {
"ValueList": [
"soln-abc987"
]
}
}
}
}
```
### Filtra i set di offerte per data di rilascio
Puoi filtrare i set di offerte per data di rilascio e ordinare i risultati utilizzando i `EntityTypeSort` parametri `EntityTypeFilters` and.
**Richiesta**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "OfferSet",
"EntityTypeFilters": {
"OfferSetFilters": {
"ReleaseDate": {
"AfterValue": "2025-11-01"
}
}
},
"EntityTypeSort": {
"OfferSetSort": {
"SortBy": "ReleaseDate",
"SortOrder": "DESCENDING"
}
}
}
```
## Descrivi un set di offerte
Per ottenere informazioni dettagliate su un set di offerte specifico, chiama l'operazione `DescribeEntity` API.
**Richiesta**
```
GET /DescribeEntity?catalog=AWSMarketplace&entityId=offerset-xyz123 HTTP/1.1
```
**Risposta**
```
{
"EntityType": "OfferSet@1.0",
"EntityId": "offerset-xyz123",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123",
"LastModifiedDate": "2025-06-25T23:46:25Z",
"DetailsDocument": {
"Id": "offerset-xyz123",
"Name": "Enterprise Security Solution Offer Set",
"BuyerNotes": "Complete security solution including endpoint protection and network monitoring",
"State": "Released",
"SolutionId": "soln-abc987",
"ReleaseDate": "2025-06-25T23:46:20Z",
"AssociatedOffers": [
{
"OfferId": "offer-abc123"
},
{
"OfferId": "offer-def456"
},
{
"OfferId": "offer-ghi789"
}
]
}
}
```
## Crea un set di offerte
Utilizza il tipo di `CreateOfferSet` modifica per creare una nuova entità del set di offerte nello stato Bozza. Questa è la prima fase del ciclo di vita del set di offerte, che stabilisce l'entità di base che verrà successivamente configurata con le associazioni di offerte e i metadati prima del rilascio agli acquirenti.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOfferSet",
"Entity": {
"Type": "OfferSet@1.0"
},
"ChangeName": "CreateOfferSetChange",
"DetailsDocument": {
"Name": "Enterprise Security Solution Offer Set"
}
}
]
}
```
Fornisci informazioni sui campi per aggiungere il tipo di modifica: `CreateOfferSet`
+ `Entity`(oggetto) (obbligatorio): il tipo di entità da creare.
+ `Type`(string) (richiesto) — Deve essere`OfferSet@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio) — I dettagli della richiesta.
+ `Name`(stringa) (obbligatorio): il nome associato al set di offerte per una migliore leggibilità per te e i tuoi clienti. Lunghezza minima: 1 carattere. Lunghezza massima: 150 caratteri.
**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 di AWS Marketplace. Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
Una volta completata l'elaborazione, Marketplace AWS genera un'offerta impostata nello stato Bozza con un identificatore univoco preceduto da. `offerset-`
## Aggiorna le informazioni sul set di offerte
Utilizza il tipo di `UpdateInformation` modifica per modificare i dettagli di un set di offerte esistente, inclusi il nome e le note dell'acquirente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "OfferSet@1.0",
"Identifier": "offerset-abc123"
},
"DetailsDocument": {
"Name": "Updated Enterprise Security Offer Set",
"BuyerNotes": "Complete security solution including endpoint protection, network monitoring, and professional services implementation"
}
}
]
}
```
Fornisci informazioni per i campi per aggiungere il tipo di `UpdateInformation` modifica:
+ `Entity`(oggetto) (obbligatorio): l'entità in fase di aggiornamento.
+ `Identifier`(stringa) (obbligatorio) — L'ID del set di offerte. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (richiesto) — Deve essere`OfferSet@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio): deve essere fornito almeno un campo.
+ `Name`(stringa) (opzionale): nome visualizzato visibile agli acquirenti. Lunghezza minima: 1 carattere. Lunghezza massima: 150 caratteri.
+ `BuyerNotes`(stringa) (opzionale): informazioni dettagliate sul set di offerte che aiutano gli acquirenti a comprenderne lo scopo e il contenuto. Lunghezza minima: 1 carattere. Lunghezza massima: 1.000 caratteri.
**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 di AWS Marketplace. Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
## Associa le offerte a un set di offerte
Utilizza il tipo di `AssociateOffers` modifica per associare più Marketplace AWS offerte a un set di offerte. Ciò crea la relazione tra le offerte e il set di offerte, rendendo le offerte parte della configurazione negoziabile del set di offerte.
L'operazione è idempotente e consente di associare le offerte indipendentemente dal loro stato attuale, abilitando la configurazione completa prima del rilascio delle singole offerte. Ogni offerta può appartenere a un solo set di offerte.
**Importante**
Le `OfferSetId` singole offerte sono immutabili e possono essere impostate solo durante la creazione dell'offerta. Prima di associare le offerte a un set di offerte utilizzando`AssociateOffers`, è necessario creare le singole offerte e specificarle `OfferSetId` durante la creazione dell'offerta. Se devi includere un'offerta esistente che non contiene l'offerta corretta`OfferSetId`, devi creare una nuova offerta con l'`OfferSetId`indicazione corretta.
Per informazioni sulle autorizzazioni IAM richieste, consulta[Autorizzazioni IAM per i set di offerte](#iam-permissions-offer-sets).
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AssociateOffers",
"Entity": {
"Type": "OfferSet@1.0",
"Identifier": "offerset-abc123"
},
"DetailsDocument": {
"Offers": [
{
"OfferId": "offer-xyz789"
},
{
"OfferId": "offer-def456"
},
{
"OfferId": "offer-ghi123"
}
]
}
}
]
}
```
Fornisci informazioni sui campi per aggiungere il tipo di `AssociateOffers` modifica:
+ `Entity`(oggetto) (obbligatorio): l'entità in fase di aggiornamento.
+ `Identifier`(stringa) (obbligatorio) — L'ID del set di offerte. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (richiesto) — Deve essere`OfferSet@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio) — I dettagli della richiesta.
+ `Offers`(array) (obbligatorio) — Elenco di Marketplace AWS offerte da associare. Minimo: 1 articolo. Massimo: 7 articoli.
+ `OfferId`(string) (obbligatorio) — L'identificatore dell' Marketplace AWS offerta. Lunghezza minima: 1 carattere. Lunghezza massima: 36 caratteri.
**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 di AWS Marketplace. Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
### Errori asincroni
I seguenti errori sono specifici `AssociateOffers` delle azioni nell'API Catalog. Marketplace AWS 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 |
| --- | --- |
| TOO\_MANY\_OFFERS | Associa fino a 7 offerte al set di offerte. |
| INCOMPATIBLE\_OFFER\_SET\_REFERENCE | Assicurati che tutte le offerte siano state create appositamente per questo set di offerte. |
| INVALID\_UPDATE\_REQUEST | La modifica richiesta non può essere eseguita dopo il rilascio del set di offerte. |
## Annulla l'associazione delle offerte da un set di offerte
Utilizza il tipo di `DisassociateOffers` modifica per rimuovere più Marketplace AWS offerte da un set di offerte. Questa operazione idempotente rimuove la relazione di associazione preservando l'attributo dell'offerta. `OfferSetId` Le offerte non associate vengono nascoste all'acquirente fino a quando non vengono riassociate allo stesso set di offerte. Non possono essere associate a un set di offerte diverso.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "DisassociateOffers",
"Entity": {
"Type": "OfferSet@1.0",
"Identifier": "offerset-abc123"
},
"DetailsDocument": {
"Offers": [
{
"OfferId": "offer-xyz789"
}
]
}
}
]
}
```
Fornisci informazioni per i campi in cui aggiungere il tipo di `DisassociateOffers` modifica:
+ `Entity`(oggetto) (obbligatorio): l'entità in fase di aggiornamento.
+ `Identifier`(stringa) (obbligatorio) — L'ID del set di offerte. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (richiesto) — Deve essere`OfferSet@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio) — I dettagli della richiesta.
+ `Offers`(array) (obbligatorio) — Elenco delle offerte da dissociare. Minimo: 1 articolo. Massimo: 7 articoli.
+ `OfferId`(string) (richiesto) — L'identificatore dell'offerta AWS Marketplace. Lunghezza minima: 1 carattere. Lunghezza massima: 36 caratteri.
**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 di AWS Marketplace. Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
### Errori asincroni
I seguenti errori sono specifici `DisassociateOffers` delle azioni nell'API Catalog. Marketplace AWS 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\_UPDATE\_REQUEST | La modifica richiesta non può essere eseguita dopo il rilascio del set di offerte. |
## Associa una soluzione a un set di offerte
Utilizza il tipo di `AssociateSolution` modifica per associare una singola soluzione AWS Marketplace a un set di offerte. Questo crea una relazione che consente agli acquirenti di scoprire la connessione del set di offerte alla soluzione e di accedere ai ricchi contenuti di marketing della soluzione, come descrizioni dettagliate, diagrammi di architettura e documentazione dei casi d'uso.
**Nota**
Si tratta di un'associazione scarsamente accoppiata. AWS Marketplace non impone la coerenza tra la soluzione e il set di offerte. Le soluzioni non possono contenere prodotti AWS Marketplace, prodotti diversi da quelli del set di offerte o prodotti sovrapposti. Hai la massima flessibilità per associare qualsiasi soluzione di tua proprietà per scopi di marketing e scoperta.
Per informazioni sulle autorizzazioni IAM richieste, consulta[Autorizzazioni IAM per i set di offerte](#iam-permissions-offer-sets).
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AssociateSolution",
"Entity": {
"Type": "OfferSet@1.0",
"Identifier": "offerset-abc123"
},
"DetailsDocument": {
"SolutionId": "soln-xyz789"
}
}
]
}
```
Fornisci informazioni sui campi per aggiungere il tipo di `AssociateSolution` modifica:
+ `Entity`(oggetto) (obbligatorio): l'entità in fase di aggiornamento.
+ `Identifier`(stringa) (obbligatorio) — L'ID del set di offerte. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (richiesto) — Deve essere`OfferSet@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio) — I dettagli della richiesta.
+ `SolutionId`(string) (richiesto) — L'identificatore della soluzione AWS Marketplace da associare. Lunghezza minima: 1 carattere. Lunghezza massima: 50 caratteri. Deve corrispondere al modello`^soln-[A-Za-z0-9]+$`.
**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 di AWS Marketplace. Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
### Errori asincroni
I seguenti errori sono specifici `AssociateSolution` delle azioni nell'API Catalog. Marketplace AWS 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 |
| --- | --- |
| ASSOCIAZIONE\_SOLUZIONE INCOMPATIBILE | Dissociate la soluzione esistente prima di associarne una nuova. |
| INVALID\_UPDATE\_REQUEST | La modifica richiesta non può essere eseguita dopo il rilascio del set di offerte. |
## Dissociare una soluzione da un set di offerte
Utilizzate il tipo di `DisassociateSolution` modifica per rimuovere l'associazione tra una soluzione e un set di offerte. Ciò rimuove i contenuti di marketing della soluzione dal set di offerte mantenendo al contempo la funzionalità negoziabile del set di offerte.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "DisassociateSolution",
"Entity": {
"Type": "OfferSet@1.0",
"Identifier": "offerset-abc123"
},
"DetailsDocument": {
"SolutionId": "soln-xyz789"
}
}
]
}
```
Fornisci informazioni sui campi per aggiungere il tipo di `DisassociateSolution` modifica:
+ `Entity`(oggetto) (obbligatorio): l'entità in fase di aggiornamento.
+ `Identifier`(stringa) (obbligatorio) — L'ID del set di offerte. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (richiesto) — Deve essere`OfferSet@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio) — I dettagli della richiesta.
+ `SolutionId`(string) (obbligatorio) — L'identificatore della soluzione da dissociare. Lunghezza minima: 1 carattere. Lunghezza massima: 50 caratteri.
**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 di AWS Marketplace. Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
### Errori asincroni
I seguenti errori sono specifici `DisassociateSolution` delle azioni nell'API Catalog. Marketplace AWS 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\_UPDATE\_REQUEST | La modifica richiesta non può essere eseguita dopo il rilascio del set di offerte. |
## Rilascia un set di offerte
Utilizza il tipo di `ReleaseOfferSet` modifica per rendere disponibile un set di offerte agli acquirenti. Una volta rilasciato, il set di offerte passa dallo stato Bozza a quello Rilasciato, diventa individuabile e le offerte associate possono essere trovate solo come parte del pacchetto unificato. Marketplace AWS
I set di offerte rilasciati generano notifiche a due livelli: le offerte individuali e il set di offerte stesso. Tutte le notifiche di offerta individuale includono i OfferSetId canali di notifica esistenti ([notifiche e-mail](https://docs.aws.amazon.com/marketplace/latest/userguide/email-notifications.html) ed [ EventBridge eventi Amazon](https://docs.aws.amazon.com/marketplace/latest/userguide/notifications-eventbridge.html)). Le notifiche a livello di set di offerte vengono inviate per eventi chiave, ad esempio quando viene rilasciato il set di offerte.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "ReleaseOfferSet",
"Entity": {
"Type": "OfferSet@1.0",
"Identifier": "offerset-abc123"
},
"DetailsDocument": {}
}
]
}
```
Fornisci informazioni sui campi in cui aggiungere il tipo di `ReleaseOfferSet` modifica:
+ `Entity`(oggetto) (obbligatorio): l'entità in fase di aggiornamento.
+ `Identifier`(stringa) (obbligatorio) — L'ID del set di offerte. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (richiesto) — Deve essere`OfferSet@1.0`.
+ `DetailsDocument`(object) (richiesto) — Oggetto vuoto per questa operazione.
**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 di AWS Marketplace. Il processo di convalida può richiedere alcuni minuti.
Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
### Errori asincroni
I seguenti errori sono specifici `ReleaseOfferSet` delle azioni nell'API Catalog. Marketplace AWS 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 |
| --- | --- |
| MISSING\_BUYER\_NOTES | Forniscilo prima di BuyerNotes rilasciare il set di offerte. |
| OFFERTE MANCANTI | Associa almeno due offerte al set di offerte prima di pubblicarlo. |
| TOO\_MANY\_OFFERTE\_PER\_PRODOTTO | Associa solo un'offerta per prodotto al set di offerte. |
| INCONSISTENT\_OFFER\_CURRENCY\_CODE | Assicurati che tutte le offerte associate corrispondano. CurrencyCode |
| INCONSISTENT\_OFFER\_AVAILABILITY\_END\_DATE | Assicurati che tutte le offerte associate corrispondano. AvailabilityEndDate |
| INCONSISTENT\_OFFER\_TARGETING\_RULE | Assicurati che tutte le offerte associate corrispondano. TargetingRule |
| INCOMPATIBLE\_OFFER\_TARGETING\_RULE | Solo le offerte destinate all'acquirente possono essere associate a un set di offerte. |
| OFFERTE\_SCADUTE | Annulla le offerte scadute dal set di offerte o prorogale. AvailabilityEndDates |
| BOZZE DI OFFERTE | Rilascia tutte le offerte associate prima di rilasciare il set di offerte. |
| STATO\_SOLUZIONE INCOMPATIBILE | Fornisci una soluzione in stato limitato o pubblico. |
| INVALID\_UPDATE\_REQUEST | La modifica richiesta non può essere eseguita dopo il rilascio del set di offerte. |
## Ciclo di vita del set di offerte
Il ciclo di vita del set di offerte comprende le seguenti fasi:
### Fase di creazione
Crea l'entità del set di offerte nello stato Bozza utilizzando il tipo di `CreateOfferSet` modifica. Il set di offerte riceve un identificatore univoco e inizia nello stato Bozza.
### Fase di configurazione
Durante la configurazione, tu:
+ Aggiungi o aggiorna i metadati utilizzando `UpdateInformation` (nome, note dell'acquirente)
+ Crea offerte private individuali, specificandole `OfferSetId` durante la creazione dell'offerta
+ Associa le offerte al set di offerte utilizzando `AssociateOffers`
+ Facoltativamente, associa una soluzione utilizzando `AssociateSolution` contenuti di marketing avanzati
**Importante**
L'impostazione `OfferSetId` sulle singole offerte è immutabile e può essere impostata solo durante la creazione dell'offerta. Prima di associare le offerte a un set di offerte utilizzando`AssociateOffers`, è necessario creare le singole offerte e specificarle `OfferSetId` durante la creazione dell'offerta. Se devi includere un'offerta esistente che non contiene l'offerta corretta`OfferSetId`, devi creare una nuova offerta con l'`OfferSetId`indicazione corretta.
### Fase di convalida
Prima di rilasciare un set di offerte, assicurati di:
+ Il set di offerte contiene da 2 a 7 offerte
+ Tutte le offerte associate devono essere:
+ Nello stato di rilascio
+ Attivo
+ Utilizzando la stessa valuta
+ Indirizzati agli stessi ID account AWS dell'acquirente
+ Con date di scadenza identiche
### Fase di rilascio
Quando sei pronto, utilizza il tipo di `ReleaseOfferSet` modifica per passare lo stato dell'offerta impostata dallo stato Bozza a quello Rilasciato. Ciò rende il set di offerte individuabile dagli acquirenti tramite Marketplace AWS.
### Post-release gestione
**Gestione delle scadenze:**
+ La scadenza effettiva di un set di offerte viene calcolata come la prima data di scadenza tra tutte le offerte associate
+ Puoi modificare le date di scadenza delle singole offerte utilizzando le funzionalità di gestione delle offerte esistenti (tipo di `UpdateAvailability` modifica)
**Modifiche al set di offerte:**
Quando gli acquirenti richiedono modifiche a un set di offerte rilasciato, utilizza il flusso di lavoro ricreativo:
1. Crea una nuova entità relativa al set di offerte
1. Per le offerte che non richiedono modifiche, clona le offerte esistenti tramite il portale di Marketplace AWS gestione
1. Per le offerte che richiedono modifiche, crea nuove offerte con le modifiche richieste, specificando le nuove `OfferSetId`
1. Associa tutte le offerte (clonate e nuove) al nuovo set di offerte utilizzando `AssociateOffers`
1. Rilascia il nuovo set di offerte utilizzando `ReleaseOfferSet`
1. Fai scadere l'offerta originale impostando la data di fine della disponibilità delle offerte associate
## Autorizzazioni IAM per i set di offerte
Per utilizzare i set di offerte utilizzando l'API Marketplace AWS Catalog, sono necessarie autorizzazioni IAM specifiche. Questa sezione descrive le autorizzazioni richieste per le operazioni relative ai set di offerte e i requisiti di autorizzazione tra entità.
### Azioni IAM richieste
Le seguenti azioni IAM sono necessarie per le operazioni relative ai set di offerte:
+ `aws-marketplace:StartChangeSet`— Obbligatoria per tutti i tipi di modifica del set di offerte, incluse le operazioni di creazione, aggiornamento, associazione e rilascio
+ `aws-marketplace:DescribeChangeSet`— Necessario per verificare lo stato e i risultati delle esecuzioni dei set di modifiche
+ `aws-marketplace:ListEntities`— Obbligatorio per elencare i set di offerte nel tuo account
+ `aws-marketplace:DescribeEntity`— Necessario per recuperare informazioni dettagliate su un set di offerte
### Autorizzazioni per le risorse
Utilizza i seguenti modelli ARN per concedere autorizzazioni su risorse specifiche:
+ **Set di offerte**: `arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*`
+ **Offerte individuali** — `arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*`
+ **Soluzioni** — `arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*`
Per autorizzazioni più restrittive, sostituisci il carattere jolly (\*) con identificatori di entità specifici.
### Cross-entity autorizzazione
Alcune operazioni relative al set di offerte richiedono autorizzazioni sia per il set di offerte che per le entità associate:
**AssociateOffers**
+ `aws-marketplace:StartChangeSet`autorizzazione sull'entità del set di offerte
+ `aws-marketplace:StartChangeSet`autorizzazione con tipo di `AssociateWithOfferSet` modifica su ogni singola entità di offerta associata
**AssociateSolution**
+ `aws-marketplace:StartChangeSet`autorizzazione sull'entità del set di offerte
+ `aws-marketplace:StartChangeSet`autorizzazione con tipo di `AssociateWithOfferSet` modifica sull'entità di soluzione associata
**Nota**
Avere l'`DescribeEntity`autorizzazione di sola lettura per offerte o soluzioni non è sufficiente per le operazioni di associazione. È necessario disporre dell'`StartChangeSet`autorizzazione per il tipo di `AssociateWithOfferSet` modifica sulle entità associate al set di offerte.
### Policy IAM di esempio
**Gestione di base del set di offerte**
Questa politica fornisce le autorizzazioni per le operazioni di base relative ai set di offerte senza associazioni tra entità:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:StartChangeSet",
"aws-marketplace:DescribeChangeSet",
"aws-marketplace:ListEntities",
"aws-marketplace:DescribeEntity"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*"
]
}
]
}
```
**Cross-entity autorizzazioni per AssociateOffers**
Questa politica dimostra le autorizzazioni e le condizioni specifiche richieste per: AssociateOffers
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "aws-marketplace:StartChangeSet",
"Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*",
"Condition": {
"StringEquals": {
"catalog:ChangeType": ["AssociateOffers"]
}
}
},
{
"Effect": "Allow",
"Action": "aws-marketplace:DescribeEntity",
"Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*"
},
{
"Effect": "Allow",
"Action": "aws-marketplace:StartChangeSet",
"Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*",
"Condition": {
"StringEquals": {
"catalog:ChangeType": ["AssociateWithOfferSet"]
}
}
}
]
}
```
Per autorizzazioni più restrittive, sostituisci il carattere jolly (\*) con identificatori di entità specifici.
**Cross-entity autorizzazioni per AssociateSolution**
Questa politica dimostra le autorizzazioni e le condizioni specifiche richieste per: AssociateSolution
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "aws-marketplace:StartChangeSet",
"Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*",
"Condition": {
"StringEquals": {
"catalog:ChangeType": ["AssociateSolution"]
}
}
},
{
"Effect": "Allow",
"Action": "aws-marketplace:DescribeEntity",
"Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
},
{
"Effect": "Allow",
"Action": "aws-marketplace:StartChangeSet",
"Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
"Condition": {
"StringEquals": {
"catalog:ChangeType": ["AssociateWithOfferSet"]
}
}
}
]
}
```
Per autorizzazioni più restrittive, sostituisci il carattere jolly (\*) con identificatori di entità specifici.