Entità del set di offerte Guida introduttiva ai set di offerte Elenca i set di offerte Descrivi un set di offerte Crea un set di offerte Aggiorna le informazioni sul set di offerte Associa le offerte a un set di offerte Annulla l'associazione delle offerte da un set di offerte Associa una soluzione a un set di offerte Dissociare una soluzione da un set di offerte Rilascia un set di offerte Ciclo di vita del set di offerte Autorizzazioni IAM per i set di offerte

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 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.
Accesso all'API e prerequisiti per il venditore completati. Per ulteriori informazioni, consulta Controllo degli accessi per l'API AWS Marketplace Catalog.
Hai appreso le nozioni di base sull'utilizzo dell'API AWS Marketplace Catalog, consulta Uso dell'API AWS Marketplace Catalog.

Elenca i set di offerte

Per elencare tutti i set di offerte presenti nel tuo account, chiama l'operazione ListEntities API con EntityType set toOfferSet.

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 essereOfferSet@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'ChangeSetIde ChangeSetArn per il set di modifiche ed è simile alla seguente.


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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò include la convalida delle informazioni per garantire che soddisfino le linee guida 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 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.
- Type(string) (richiesto) — Deve essereOfferSet@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'ChangeSetIde ChangeSetArn per il set di modifiche ed è simile alla seguente.


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

Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione DescribeChangeSet 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 utilizzandoAssociateOffers, è necessario creare le singole offerte e specificarle OfferSetId durante la creazione dell'offerta. Se devi includere un'offerta esistente che non contiene l'offerta correttaOfferSetId, devi creare una nuova offerta con l'OfferSetIdindicazione corretta.

Per informazioni sulle autorizzazioni IAM richieste, consultaAutorizzazioni IAM per i set di offerte.

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.
- Type(string) (richiesto) — Deve essereOfferSet@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'ChangeSetIde ChangeSetArn per il set di modifiche ed è simile alla seguente.


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

Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione DescribeChangeSet 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, vedereUtilizzo dei set di modifiche.

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.
- Type(string) (richiesto) — Deve essereOfferSet@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'ChangeSetIde ChangeSetArn per il set di modifiche ed è simile alla seguente.


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

Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione DescribeChangeSet 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, vedereUtilizzo dei set di modifiche.

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, consultaAutorizzazioni IAM per i set di offerte.

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.
- Type(string) (richiesto) — Deve essereOfferSet@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'ChangeSetIde ChangeSetArn per il set di modifiche ed è simile alla seguente.


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

Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione DescribeChangeSet 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, vedereUtilizzo dei set di modifiche.

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.
- Type(string) (richiesto) — Deve essereOfferSet@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'ChangeSetIde ChangeSetArn per il set di modifiche ed è simile alla seguente.


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

Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione DescribeChangeSet 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, vedereUtilizzo dei set di modifiche.

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 ed EventBridge eventi Amazon). 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.
- Type(string) (richiesto) — Deve essereOfferSet@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'ChangeSetIde ChangeSetArn per il set di modifiche ed è simile alla seguente.


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

Puoi controllare lo stato della richiesta tramite l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione DescribeChangeSet 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, vedereUtilizzo dei set di modifiche.

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 utilizzandoAssociateOffers, è necessario creare le singole offerte e specificarle OfferSetId durante la creazione dell'offerta. Se devi includere un'offerta esistente che non contiene l'offerta correttaOfferSetId, devi creare una nuova offerta con l'OfferSetIdindicazione 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:

Crea una nuova entità relativa al set di offerte
Per le offerte che non richiedono modifiche, clona le offerte esistenti tramite il portale di Marketplace AWS gestione
Per le offerte che richiedono modifiche, crea nuove offerte con le modifiche richieste, specificando le nuove OfferSetId
Associa tutte le offerte (clonate e nuove) al nuovo set di offerte utilizzando AssociateOffers
Rilascia il nuovo set di offerte utilizzando ReleaseOfferSet
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:StartChangeSetautorizzazione sull'entità del set di offerte
aws-marketplace:StartChangeSetautorizzazione con tipo di AssociateWithOfferSet modifica su ogni singola entità di offerta associata

AssociateSolution

aws-marketplace:StartChangeSetautorizzazione sull'entità del set di offerte
aws-marketplace:StartChangeSetautorizzazione con tipo di AssociateWithOfferSet modifica sull'entità di soluzione associata

Nota

Avere l'DescribeEntityautorizzazione di sola lettura per offerte o soluzioni non è sufficiente per le operazioni di associazione. È necessario disporre dell'StartChangeSetautorizzazione 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.

Convenzioni dei documenti

Lavora con soluzioni

Crea interfacce con i dati del catalogo