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 soluzioni
Una soluzione è un insieme di prodotti e servizi che interagiscono per risolvere problemi specifici dei clienti. Le soluzioni possono includere prodotti AWS Marketplace e prodotti non AWS Marketplace. Le soluzioni ti aiutano a mostrare come si integrano più prodotti per affrontare casi d'uso specifici del settore. La soluzione descrive il problema del cliente, i casi d'uso, i dettagli dell'integrazione e i prodotti correlati.
## Soluzioni in AWS Marketplace e AWS Partner Central
Quando esegui la migrazione da Partner Central 2.0 a Partner Central 3.0, ti viene richiesto di creare un account AWS e registrarti come venditore AWS Marketplace. Per ulteriori informazioni, consulta [Registrati e crea il tuo profilo venditore](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html). Questa registrazione è necessaria per:
+ Esegui la migrazione delle soluzioni Partner Central esistenti al catalogo di AWS Marketplace (tutte le soluzioni verranno migrate al `AWSMarketplace` catalogo)
+ Consenti alle tue soluzioni AWS Marketplace di funzionare con le API Partner Central, come le [API di vendita](https://docs.aws.amazon.com/partner-central/latest/APIReference/working-with-your-opportunities.html).
### Comprendere il collegamento e la migrazione dei profili
Esistono due scenari distinti per connettere i tuoi account Partner Central e AWS Marketplace:
**Solo collegamento al profilo**: se colleghi i tuoi account AWS Partner Central e AWS senza effettuare la migrazione a Partner Central 3.0, le soluzioni AWS Marketplace e le soluzioni Partner Central rimangono separate. Gestisci ogni piattaforma in modo indipendente.
**Migrazione del profilo**: quando esegui la migrazione a Partner Central 3.0 con profili di venditore AWS Marketplace collegati:
+ Le tue soluzioni Partner Central 2.0 migrano verso AWS Marketplace
+ Gestisci le soluzioni solo tramite AWS Marketplace
+ Le API di Partner Central possono accedere a soluzioni migrate
**Nota**
Se hai già collegato i tuoi account AWS Partner Central e AWS (vedi [Collegamento degli account AWS Partner Central e AWS](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html)), non è necessario creare un nuovo account AWS. Tuttavia, verifica che il tuo account AWS esistente sia registrato come venditore AWS Marketplace. Per rendere la tua soluzione disponibile al pubblico sul sito web per gli acquirenti di AWS Marketplace, devi avere un profilo pubblico come venditore di AWS Marketplace. Per le istruzioni per la registrazione del venditore su AWS Marketplace, consulta [Registrati e crea il tuo profilo venditore](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html).
### Rendere disponibili soluzioni AWS Marketplace preesistenti per le API Partner Central
Le soluzioni AWS Marketplace create prima della migrazione del profilo Partner Central 3.0 non vengono riconosciute automaticamente dalle API Partner Central. Questo vale anche dopo aver completato la migrazione e collegato il tuo account AWS a un account Partner Central.
Per rendere visibile una soluzione di pre-migrazione esistente alle API di Partner Central, aggiorna qualsiasi campo della soluzione. Puoi inserire le stesse informazioni attualmente disponibili. Ripeti questo processo per ogni soluzione creata prima della migrazione del profilo Partner Central 3.0.
Ad esempio, utilizzate il tipo di `UpdateInformation` modifica per aggiornare il nome di una soluzione con il suo valore corrente. Dopo aver aggiornato una soluzione una volta, le API di Partner Central riconosceranno automaticamente eventuali aggiornamenti futuri di tale soluzione.
## Entità della soluzione
Una soluzione è un documento di marketing che aiuta gli acquirenti a scoprire e comprendere le tue offerte. Le soluzioni contengono un titolo, una descrizione, casi d'uso, prodotti AWS Marketplace e prodotti non AWS Marketplace. La soluzione è un tipo di entità separato dal prodotto, dall'offerta e dai set di offerte. Ogni soluzione offre una propria esperienza di scoperta e pubblicazione delle inserzioni, che gli acquirenti possono consultare separatamente dai singoli prodotti.
**Caratteristiche chiave**
+ Raggruppa più prodotti, inclusi prodotti AWS Marketplace e prodotti non AWS Marketplace.
+ Crea un'esperienza di scoperta e inserzione dedicata agli acquirenti.
+ Raggruppa i prodotti di tua proprietà con prodotti di altri venditori.
Il tipo di entità della soluzione è`Solution@1.0`.
**Identificatori di entità**
Le soluzioni utilizzano il formato `soln-*` identificativo (ad esempio,`soln-abc123def456`).
**Formato ARN dell'entità**
Le soluzioni seguono il formato AWS ARN standard:
```
arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id}
```
Esempio:
```
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456
```
## Guida introduttiva alle soluzioni
Questa sezione fornisce informazioni dettagliate sulla creazione e la gestione di soluzioni utilizzando i [tipi di modifica](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Change.html) dell'API AWS Marketplace Catalog.
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 le tue soluzioni
Per elencare tutte le soluzioni presenti nel tuo account, chiama l'`ListEntities`operatore API e imposta su `EntityType` Soluzione.
**Richiesta**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "Solution"
}
```
**Risposta**
```
{
"EntitySummaryList": [
{
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
"EntityId": "soln-abc123456",
"EntityType": "Solution",
"LastModifiedDate": "2024-10-10T19:50:43Z",
"Name": "Test Solution 1",
"Visibility": "Limited"
}
],
"NextToken": null
}
```
### Filtra le soluzioni in base alla visibilità
È possibile filtrare le soluzioni in base alla visibilità utilizzando il `FilterList` parametro.
**Richiesta**
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "Solution",
"FilterList": [
{
"Name": "Visibility",
"ValueList": [
"Public"
]
}
]
}
```
## Ottieni i dettagli della soluzione
Per ottenere informazioni dettagliate su una soluzione specifica, chiama l'operatore dell'`DescribeEntity`API.
**Nota**
La DescribeEntity risposta restituisce una soluzione `EntityIdentifier` che combina un `EntityId` con una `RevisionId.` soluzione For, `EntityId` è l'ID della soluzione e `RevisionId` può essere utilizzata per un blocco ottimistico. [Per ulteriori informazioni, vedere Identificatori.](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)
**Richiesta**
```
GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1
```
**Risposta**
```
{
"Details": "{...}",
"DetailsDocument": {
"Lifecycle": {
"Visibility": "Limited"
},
"Identifiers": {
"Id": "soln-abc123456"
},
"Presentation": {
"Title": "My Solution",
"Name": "solution_for_customer_X",
"ShortDescription": "Solution value proposition",
"LongDescription": "Detailed solution description",
"LogoUrl": "https://s3.amazonaws.com/logo.jpg",
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Use case description"
}
]
},
"RelatedProducts": {
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
}
],
"IntegrationDescription": "How products work together",
"NonAwsMarketplaceProducts": [
{
"Type": "Hardware",
"Title": "A hardware product",
"Url": "https://example.com",
"Description": "My hardware product description"
}
]
},
"BuyerEngagement": [
{
"EngagementOption": "RequestPrivateOffer"
}
]
},
"EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
"EntityIdentifier": "soln-abc123456@12",
"EntityType": "Solution@1.0",
"LastModifiedDate": "2025-04-22T01:02:48Z"
}
```
## Elenca la cronologia delle modifiche per una soluzione
Per visualizzare la cronologia delle modifiche per una soluzione specifica, richiama l'operazione `ListChangeSets` API con un filtro di entità.
**Sintassi della richiesta**
```
POST /ListChangeSets HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"FilterList": [
{
"Name": "EntityId",
"ValueList": [
"soln-abc123456"
]
}
]
}
```
## Contrassegna le soluzioni e i set di modifiche
È possibile aggiungere tag alle soluzioni e modificare i set durante la creazione o aggiornarli in un secondo momento.
**Etichetta durante la creazione**
È possibile aggiungere `EntityTags` solo al tipo di `CreateSolution` modifica, non ad altri tipi di modifica della soluzione. È possibile aggiungerlo `ChangeSetTags` a qualsiasi `StartChangeSet` payload.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"DetailsDocument": {
"Name": "Test solution resource name"
},
"EntityTags": [
{
"Key": "Team",
"Value": "Solutions"
}
]
}
],
"ChangeSetTags": [
{
"Key": "Environment",
"Value": "Production"
}
]
}
```
**Gestisci i tag sulle risorse esistenti**
Utilizza le operazioni `TagResource` e `UntagResource` API per gestire i tag sulle soluzioni esistenti e sui set di modifiche. Utilizzare `ListTagsForResource` per visualizzare i tag correnti.
Per ulteriori informazioni, vedere [Gestione dei tag sulle risorse](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#managing-tags-on-resources) e [Aggiungere tag a un'entità e modificare il set durante la creazione](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#example-adding-tags-entity-creation).
## Crea una soluzione
È possibile utilizzare il tipo di `CreateSolution` modifica per creare un nuovo documento di soluzione con solo un ID e un nome della soluzione. Gli altri valori non sono ancora stati inseriti.
Quando la tua richiesta viene elaborata correttamente, AWS Marketplace crea una `Draft` soluzione pronta per te. Questa soluzione incompleta non è visibile agli acquirenti su AWS Marketplace.
Utilizza quindi altri tipi di modifiche per completare la soluzione:`UpdateInformation`,`UpdateRelatedProducts`, `UpdateBuyerEngagementOptions` (facoltativo per la creazione di una `Limited` soluzione), e`ReleaseSolution`. Il tipo di `ReleaseSolution` modifica verifica che tutti i campi obbligatori necessari per una `Limited` soluzione siano presenti nella soluzione e quindi la sposta in `Limited` visibilità.
**Nota**
Per spostare una soluzione allo stato Pubblico o modificare lo stato di una soluzione, utilizza il tipo di `UpdateVisibility` modifica dopo aver fornito i valori richiesti.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"ChangeName": "CreateSolutionChange",
"DetailsDocument": {
"Name": "solution_for_customerX_en",
"Title": "New Partner Solution"
}
}
]
}
```
Fornisci informazioni sui campi per aggiungere il tipo di `CreateSolution` modifica:
+ `Entity`(oggetto) (obbligatorio): il tipo denominato dell'entità di soluzione che viene creata.
+ `Type`(string) (obbligatorio) — `Type` Deve essere`Solution@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio) — I dettagli della richiesta.
+ `Name`(stringa) (obbligatorio) — Nome della risorsa AWS a titolo di riferimento esclusivo del venditore (non visibile agli acquirenti). Lunghezza massima: 100 caratteri. Non deve contenere spazi bianchi iniziali o finali, interruzioni di riga o caratteri di controllo. È inoltre possibile aggiornare il riquadro della soluzione tramite il tipo di modifica. `UpdateInformation`
+ `Title`(string) (opzionale) — Il titolo della soluzione. Lunghezza massima: 255 caratteri. Non deve contenere spazi bianchi iniziali o finali, interruzioni di riga o caratteri di controllo. È inoltre possibile impostare o aggiornare il titolo della soluzione tramite il tipo di modifica. `UpdateInformation`
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta ti dà `ChangeSetId` e`ChangeSetArn`:
```
{
"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 utilizzando l'AWS Marketplace Management Portal o il funzionamento dell'`DescribeChangeSet`API.
Quando la richiesta viene completata con successo (se lo `Status` è`SUCCEEDED`), viene generato un nuovo ID della soluzione.
**Errori asincroni**
`CreateSolution`le azioni restituiscono errori specifici, oltre ai [comuni](#solution-error-codes) errori asincroni. Questi errori vengono ricevuti al `DescribeChangeSet` termine dell'elaborazione di un set di modifiche. Per informazioni su come ottenere lo stato delle richieste di modifica, consulta [Lavorare con i set di modifiche](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| NOME\_NON VALIDO | La lunghezza del nome della soluzione non è valida. Inserisci un nome compreso tra 1 e 100 caratteri e riprova. |
| NOME\_MANCANTE | È richiesto un valore Name. Specificate un valore Name e riprovate. |
| INVALID\_TITLE | La lunghezza del titolo della soluzione non è valida. Inserisci un titolo compreso tra 1 e 255 caratteri e riprova. |
## Aggiorna le informazioni sulla soluzione
Se disponi già di una soluzione in AWS Marketplace, puoi utilizzare l'API Catalog per aggiornare le informazioni sulla soluzione.
Per aggiornare le informazioni sulla soluzione, chiama l'`StartChangeSet`operatore dell'API con il tipo di `UpdateInformation` modifica e i dettagli aggiornati. Guarda l'esempio seguente.
**Nota**
I tipi di `UpdateInformation` modifica si comportano come operazioni HTTP PATCH per gli attributi di primo livello. Come vengono aggiornati i campi:
Se è presente un attributo di primo livello in`DetailsDocument`, il flusso di lavoro convalida l'input e sovrascrive i valori esistenti.
Se un campo di primo livello non è presente in`DetailsDocument`, il valore esistente viene mantenuto.
Per annullare l'impostazione di un campo opzionale, invia un JSON `null` esplicito per quel campo.
AWS Marketplace verifica e inserisce logo e risorse multimediali promozionali in una sede Marketplace-owned AWS. DescribeEntity restituisce un URL accessibile per i file importati, non l'input originale da. StartChangeSet Per visualizzare gli URL inviati originali, utilizza l'API. DescribeChangeSet
**Nota**
Quando modifichi i file `PromotionalMedia` degli asset (fornendo nuovi URL) su una `Public` soluzione, è `UpdateInformation` necessaria una revisione manuale da parte del team Seller Operations di AWS Marketplace. Ciò aumenta i tempi di esecuzione. In questo scenario, `UpdateInformation` viene utilizzato separatamente nel proprio set di modifiche.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Identifier": "soln-1234abcd",
"Type": "Solution@1.0"
},
"DetailsDocument": {
"Name": "project_cold_harbor",
"Title": "My Awesome Solution",
"ShortDescription": "Solution value proposition",
"LongDescription": "Detailed solution description explaining how this addresses customer needs",
"LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg",
"PromotionalMedia": [
{
"Type": "Image",
"Url": "https://s3.amazonaws.com/awsmp-media/image.jpg",
"Title": "Sample image",
"Description": "Sample image description"
},
{
"Type": "Video",
"Url": "https://s3.amazonaws.com/awsmp-media/video.mp4",
"Title": "Sample video",
"PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png",
"Description": "Sample video description"
}
],
"AdditionalResources": [
{
"Text": "Troubleshooting guide",
"Url": "https://example.com/troubleshooting"
}
],
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Highlight description of this use case"
}
]
}
}
]
}
```
Fornisci informazioni sui campi per aggiungere il tipo di `UpdateInformation` modifica:
+ `Entity`(oggetto) (obbligatorio): il tipo di entità denominato da aggiornare.
+ `Identifier`(string) (richiesto) — L'ID della soluzione.
+ `Type`(string) (richiesto) — Deve essere`Solution@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio): i dettagli della richiesta, incluse le informazioni che si desidera aggiornare per la soluzione. Ogni campo è facoltativo, ma è necessario includere almeno una modifica da aggiornare.
+ `Name`(stringa): il nome della risorsa della soluzione, visibile solo al venditore tramite le operazioni di lettura dell'API del catalogo, non visibile agli acquirenti. Lunghezza massima: 100 caratteri. Non deve contenere spazi bianchi iniziali o finali, interruzioni di riga o caratteri di controllo.
+ `Title`(stringa) — Il titolo della soluzione da mostrare agli acquirenti. Lunghezza massima: 255 caratteri. Non deve contenere spazi bianchi iniziali o finali, interruzioni di riga o caratteri di controllo.
+ `ShortDescription`(stringa) — La descrizione della proposta di valore degli aspetti chiave della soluzione da mostrare agli acquirenti. Di solito si tratta di 2-3 frasi. Lunghezza massima: 1000 caratteri. Non deve contenere spazi bianchi iniziali o finali o caratteri di controllo.
+ `LongDescription`(stringa) — La descrizione più lunga di questa soluzione da mostrare agli acquirenti. Di solito si tratta di 1-3 paragrafi. Lunghezza massima: 5000 caratteri. Non deve contenere spazi bianchi iniziali o finali o caratteri di controllo.
+ `LogoUrl`(stringa) — L'URL di un'immagine in un bucket Amazon S3 accessibile pubblicamente o in un URL S3 predefinito. Deve essere un URL S3 diretto (non dietro CloudFront o API Gateway). Lunghezza massima: 2048 caratteri. Per le specifiche del logo, consulta [Requisiti relativi al logo dell'azienda e del prodotto](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos).
+ `PromotionalMedia`(serie di oggetti): elenco di immagini e video promozionali. Massimo 15 articoli (5 video e 10 immagini). Per le specifiche dei media promozionali, consulta [Migliora il tuo prodotto AWS Marketplace con supporti promozionali](https://docs.aws.amazon.com/marketplace/latest/userguide/promotional-media.html).
+ `Type`(string) (obbligatorio) — `Image` O`Video`.
+ `Url`(string) (obbligatorio) — L'URL del file multimediale. Deve essere un URL S3 diretto o un URL S3 predefinito. Lunghezza massima: 2048 caratteri. Deve essere un URL https.
+ `Title`(string) (obbligatorio) — Il titolo del file multimediale. Lunghezza massima: 100 caratteri. Non deve contenere spazi bianchi iniziali o finali, interruzioni di riga o caratteri di controllo.
+ `Description`(string) (obbligatorio) — La descrizione del file multimediale. Lunghezza massima: 200 caratteri. Non deve contenere spazi bianchi iniziali o finali o caratteri di controllo.
+ `PreviewUrl`(stringa) (opzionale): solo per i video, l'URL di un'immagine di anteprima. Lunghezza massima: 2048 caratteri. Deve essere un URL https.
+ `AdditionalResources`(matrice di oggetti) — L'elenco dei riferimenti a risorse aggiuntive. Massimo 8 articoli.
+ `Text`(stringa) — Il nome o il titolo della risorsa. Lunghezza massima: 500 caratteri. Non deve contenere spazi bianchi iniziali o finali, interruzioni di riga o caratteri di controllo.
+ `Url`(stringa) — L'URL della risorsa. Lunghezza massima: 2048 caratteri. Deve essere un URL https.
+ `UseCases`(matrice di oggetti): l'elenco dei casi d'uso risolti da questa soluzione. Massimo 3 articoli. Per le categorie di casi d'uso valide (una combinazione di Group e Item) SubGroup, consulta [l'elenco delle categorie di casi d'uso](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json) per i valori attivi accettati e le relative [etichette di introduzione](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/i18n/en.json). La combinazione di Group e Item deve essere un elemento valido nell'elenco delle categorie dei casi d'uso. SubGroup
+ `Group`(stringa) — Categoria industriale o tecnologica. Deve essere uno dei valori del Gruppo nell'[elenco delle categorie dei casi d'uso](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `SubGroup`(stringa) — Utilizza il gruppo di casi all'interno della categoria. Deve essere uno dei SubGroup valori nell'[elenco delle categorie dei casi d'uso](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `Item`(stringa) — Caso d'uso specifico. Deve essere uno dei valori dell'articolo nell'[elenco delle categorie dei casi d'uso](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json).
+ `Description`(stringa) — Descrizione di come questa soluzione affronta il caso d'uso. Lunghezza massima: 500 caratteri. Non deve contenere spazi bianchi iniziali o finali o caratteri di controllo.
Per informazioni sugli URL predefiniti, consultate [Condivisione](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html) di oggetti con URL predefiniti.
**Nota**
Quando chiami UpdateInformation change type, puoi sempre fornire un sottoinsieme di campi da aggiornare nell'oggetto. `DetailsDocument` Tuttavia, prima di spostare una soluzione da `Draft` a`Limited`, è necessario impostare correttamente i seguenti campi:`Title`, `ShortDescription``LongDescription`, e`LogoUrl`.
Tuttavia, quando si aggiornano i campi esistenti sulla soluzione, è possibile includere solo gli attributi che devono essere modificati nell'`DetailsDocument`oggetto del tipo di `UpdateInformation` modifica.
**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. Per verificare lo stato della richiesta, utilizza l'AWS Marketplace Management Portal o chiama l'`DescribeChangeSet`API.
Dopo aver attivato questo tipo di modifica con `PromotionalMedia` gli asset modificati per una `Public` soluzione, il completamento del processo può richiedere fino a 37 giorni. Ciò include il tempo necessario al Seller Operations Team di AWS Marketplace per esaminare, controllare e approvare.
**Errori asincroni**
Oltre ai [comuni errori asincroni, i seguenti errori](#solution-error-codes) sono specifici delle `UpdateInformation` azioni nell'API AWS Marketplace Catalog. Questi errori vengono restituiti quando si chiama `DescribeChangeSet` dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo per `DescribeChangeSet` ottenere lo stato di una richiesta di modifica, consulta [Lavorare con i set di modifiche](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_SHORT\_DESCRIPTION | La lunghezza della soluzione ShortDescription non è valida. Inserisci un ShortDescription carattere compreso tra 1 e 1000 caratteri e riprova. |
| INVALID\_LONG\_DESCRIPTION | La lunghezza della soluzione LongDescription non è valida. Inserisci un LongDescription carattere compreso tra 1 e 5000 caratteri e riprova. |
| NOME\_NON VALIDO | La lunghezza del nome della soluzione non è valida. Inserisci un nome compreso tra 1 e 100 caratteri e riprova. |
| INVALID\_TITLE | La lunghezza del titolo della soluzione non è valida. Inserisci un titolo compreso tra 1 e 255 caratteri e riprova. |
| INVALID\_ADDITIONAL\_RESOURCES | La soluzione AdditionalResources [%d] .La lunghezza del testo non è valida. Inserisci un testo compreso tra 1 e 500 caratteri e riprova. |
| INVALID\_ADDITIONAL\_RESOURCES | I seguenti URL nelle risorse aggiuntive fornite non sono accessibili: [%s]. Fornisci URL validi e accessibili |
| INVALID\_ADDITIONAL\_RESOURCES | È richiesto un valore Url. Specificate un valore Url e riprovate. |
| INVALID\_ADDITIONAL\_RESOURCES | Il testo non può mancare. Fornisci un testo |
| INVALID\_USE\_CASE | La soluzione UseCases [%d] .La lunghezza della descrizione non è valida. Inserisci una descrizione compresa tra 1 e 500 caratteri e riprova. |
| INVALID\_USE\_CASE | UseCases[%d] .Group: Il gruppo fornito (%s) non è valido. Fornisci un gruppo valido. |
| INVALID\_USE\_CASE | UseCases[%d]. SubGroup: Il gruppo fornito (%s) non è valido. Fornisci un valore valido. SubGroup |
| INVALID\_USE\_CASE | UseCases[%d] .Item: L'elemento fornito (%s) non è valido. Fornisci un articolo valido. |
| INVALID\_USE\_CASE | UseCases[%d] .Item: il caso d'uso fornito è inattivo. Fornisci un caso d'uso attivo |
| INVALID\_USE\_CASE | UseCases[%d] .Group: il gruppo non può mancare. Fornisci un gruppo. |
| INVALID\_USE\_CASE | UseCases[%d]. SubGroup: SubGroup non può mancare. Fornisci un SubGroup. |
| INVALID\_USE\_CASE | UseCases[%d] .Item: non può mancare. SubGroup Fornisci un articolo. |
| INVALID\_MEDIA | La soluzione PromotionalMedia [%d] .La lunghezza del titolo non è valida. Inserisci un titolo compreso tra 1 e 100 caratteri e riprova. |
| INVALID\_MEDIA | La soluzione PromotionalMedia [%d] .La lunghezza della descrizione non è valida. Inserisci una descrizione compresa tra 1 e 200 caratteri e riprova. |
| INVALID\_MEDIA | URL non valido: %s Fornisci un nuovo URL per i file multimediali archiviati in S3. |
| INVALID\_MEDIA | Posizione multimediale non accessibile: %s Fornisci un nuovo URL accessibile per i file multimediali archiviati in una delle seguenti posizioni: [S3]. |
| INVALID\_MEDIA | La dimensione dell'immagine supera %s. Fornisci un'immagine inferiore a %s. |
| INVALID\_MEDIA | Le dimensioni del video superano %s. Fornisci un video inferiore a %s. |
| INVALID\_MEDIA | La dimensione del logo supera %s. Fornisci un logo che sia inferiore a %s. |
| INVALID\_MEDIA | Malware rilevato in %s. Fornisci contenuti multimediali senza malware. |
| INVALID\_MEDIA | Contenuto inappropriato: %s rilevato. Fornisci contenuti multimediali senza contenuti inappropriati |
| MEDIA NON VALIDI | Rilevato contenuto esplicito in %s: '{}'. ExplicitContent Fornisci contenuti multimediali senza contenuti espliciti. |
| INVALID\_MEDIA | PromotionalMedia[%s] .Url: %s non è in un formato supportato (%s). Usa un'immagine ben formata in un formato supportato: [JPEG, PNG]. |
| SUPPORTO\_NON VALIDO | PromotionalMedia[%s] .Url: %s non è in un formato supportato (%s). Usa un video ben formato in un formato supportato: [MP4, MOV]. |
| SUPPORTO\_NON VALIDO | LogoUrl in %s ha proporzioni non valide. Fornisci un'immagine con proporzioni 1:1 (quadrato) o 2:1 (ampio). |
| SUPPORTO\_NON VALIDO | Logo: %s ha dimensioni non valide. Fornisci un'immagine tra 120x120 e 1080x1080 pixel. |
| SUPPORTO\_NON VALIDO | PromotionalMedia[%d] .Type non è supportato. Fornisci PromotionalMedia un tipo supportato: %s |
| MEDIA\_DUPLICATI | Sono stati rilevati file multimediali duplicati: [%s] Fornisci elementi multimediali senza duplicati. |
| INVALID\_MEDIA | PromotionalMedia[%d] .Url: malware rilevato in %s. Fornisci contenuti multimediali senza malware. |
| TOO\_MANY\_ITEMS | Fornisci non più di %d %s. |
## Aggiorna i prodotti correlati
Puoi utilizzare l'API Catalog per aggiornare i prodotti e i servizi inclusi nella tua soluzione, inclusi prodotti AWS Marketplace e prodotti non AWS Marketplace.
Per aggiornare i prodotti correlati, richiama l'operazione `StartChangeSet` API con il tipo di `UpdateRelatedProducts` modifica, come mostrato nell'esempio seguente.
**Nota**
Il tipo di `UpdateRelatedProducts` modifica si comporta come un'operazione HTTP PATCH per gli attributi di primo livello. Puoi fornire tutti i tipi di prodotti AWS Marketplace attuali come indicato `AwsMarketplaceProducts` di seguito`UpdateRelatedProducts`.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateRelatedProducts",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-123456"
},
"DetailsDocument": {
"IntegrationDescription": "How to use the products in this solution (usage guide)",
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
},
{
"ProductId": "prod-456"
}
],
"NonAwsMarketplaceProducts": [
{
"Type": "Hardware",
"Title": "Diamond engine",
"Description": "Hardware details",
"Url": "https://example.com/hardware-product-specs.html"
}
]
}
}
]
}
```
Fornisci informazioni per i campi in cui aggiungere il tipo di `UpdateRelatedProducts` modifica:
+ `Entity`(oggetto) (obbligatorio): il tipo di entità denominato da aggiornare.
+ `Identifier`(string) (richiesto) — L'ID della soluzione.
+ `Type`(string) (richiesto) — Deve essere`Solution@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio) — I dettagli della richiesta. Ogni campo è facoltativo, ma è necessario includere almeno una modifica da aggiornare.
+ `IntegrationDescription`(stringa) — Descrizione del modo in cui i prodotti interagiscono in questa soluzione. Lunghezza massima: 5000 caratteri. Non deve contenere spazi bianchi iniziali o finali o caratteri di controllo.
+ `AwsMarketplaceProducts`(array di oggetti): prodotti AWS Marketplace inclusi in questa soluzione. Massimo 5 articoli
+ `ProductId`(stringa) — ID del prodotto AWS Marketplace (un UUID o una stringa che inizia con`prod-`). Lunghezza massima: 50 caratteri.
+ `NonAwsMarketplaceProducts`(serie di oggetti) — Prodotti non disponibili su AWS Marketplace. Massimo 5 articoli.
+ `Type`(stringa) (obbligatorio) — Tipo di prodotto. Valori possibili: `Software``Consulting`,`Hardware`,`Communication`,`Professional Service`,`Managed Service`,`Value-Added Resale`, `Training`
+ `Title`(stringa) (obbligatorio) — Titolo del prodotto. Lunghezza massima: 255 caratteri. Non deve contenere spazi bianchi iniziali o finali, interruzioni di riga o caratteri di controllo.
+ `Description`(stringa) (opzionale) — Descrizione del prodotto. Lunghezza massima: 220 caratteri. Non deve contenere spazi bianchi iniziali o finali o caratteri di controllo.
+ `Url`(stringa) (opzionale): URL per ulteriori informazioni sul prodotto. Lunghezza massima: 2048 caratteri. Deve essere un URL https.
**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.
Per verificare lo stato della richiesta, utilizza l'AWS Marketplace Management Portal o chiama l'`DescribeChangeSet`API.
**Errori asincroni**
Oltre ai [comuni errori asincroni, i seguenti errori](#solution-error-codes) sono specifici delle `UpdateRelatedProducts` azioni nell'API AWS Marketplace Catalog. Questi errori vengono restituiti quando si chiama `DescribeChangeSet` dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo per `DescribeChangeSet` ottenere lo stato di una richiesta di modifica, consulta [Lavorare con i set di modifiche](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| SOLUZIONE INCOMPATIBLE\_OPERATION\_UPDATE\_RELATED\_PRODUCTS\_ | L'operazione di aggiornamento dei prodotti correlati non è supportata per le soluzioni pubbliche. Per apportare questa modifica, imposta innanzitutto la visibilità della soluzione su Limitata e riprova. |
| NON VALIDO\_ AWS\_MARKETPLACE\_PRODUCTS | Il prodotto AWS Marketplace '%s' non è disponibile per il tuo account. Scegli un prodotto pubblico o un prodotto limitato a cui hai accesso alla lista consentita oppure contatta il venditore per richiedere l'accesso. |
| NON VALIDO\_ AWS\_MARKETPLACE\_PRODUCTS | Il tipo di prodotto specificato «%s» non è supportato. Fornisci uno di questi tipi di prodotto validi: [AmiProduct, SaasProduct,, ContainerProduct, MachineLearningProduct ProfessionalServicesProduct, DataProduct] e riprova. |
| NON VALIDO\_ AWS\_MARKETPLACE\_PRODUCTS | Prodotto «%s» non trovato. Fornisci un ID prodotto valido nello stesso catalogo. |
| NON VALIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | Gli URL dei prodotti Non-AWS Marketplace specificati non sono accessibili: [%s]. Verifica che gli URL siano validi e accessibili pubblicamente e riprova. |
| DESCRIZIONE\_INTEGRATION\_NON VALIDA | Fornisci una soluzione compresa tra 1 e 5000 caratteri. IntegrationDescription |
| NON VALIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | La soluzione NonAwsMarketplaceProduct [%d] .La lunghezza del titolo non è valida. Inserisci una descrizione compresa tra 1 e 255 caratteri e riprova. |
| NON VALIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | La soluzione NonAwsMarketplaceProduct [%d] .La lunghezza della descrizione non è valida. Inserisci una descrizione compresa tra 1 e 220 caratteri e riprova. |
| NON VALIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | La soluzione NonAwsMarketplaceProduct [%d] .La lunghezza del tipo non è valida. Inserisci un tipo compreso tra 1 e 50 caratteri e riprova. |
| NON VALIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d] .Type non è un tipo di prodotto non valido di AWS Marketplace. Fornisci uno dei seguenti tipi di prodotto non AWS Marketplace: [%s] |
| NON VALIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | È richiesto un NonAwsMarketplaceProduct valore [%d] .Title. Specificate un valore per il titolo e riprovate. |
| NON VALIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | È richiesto un NonAwsMarketplaceProduct valore [%d] .Type. Specificate un valore Type e riprovate. |
| TOO\_MANY\_PRODUCTS | Il numero massimo di prodotti AWS Marketplace che puoi collegare è %d. Rimuovi i prodotti collegati esistenti prima di aggiungerne di nuovi. |
| TOO\_MANY\_PRODUCTS | Il numero massimo di nessun prodotto AWS Marketplace che puoi aggiungere è %d. Rimuovi i prodotti AWS Marketplace non esistenti prima di aggiungerne di nuovi. |
| NON VALIDO\_ AWS\_MARKETPLACE\_PRODUCTS | Gli ID di prodotto AWS Marketplace duplicati non sono consentiti. Ogni ID di prodotto deve essere unico nella tua soluzione. |
| INVALID\_REMOVE\_OPERATION | Operazione non valida, non è possibile rimuovere tutti i prodotti. |
## Rilascia una soluzione
Puoi utilizzare l'API Catalog per pubblicare una `Draft` soluzione in `Limited` visibilità in AWS Marketplace.
Il tipo di `ReleaseSolution` modifica verifica la presenza di tutti i campi obbligatori per una `Limited` soluzione. Quindi sposta la soluzione dalla `Draft` `Limited` visibilità. Una volta che una soluzione è `Limited` visibile, non è possibile riportarla alla `Draft` visibilità.
Per rilasciare una soluzione, chiamate l'operazione `StartChangeSet` API con il tipo di `ReleaseSolution` modifica, come illustrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "ReleaseSolution",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {}
}
]
}
```
Fornisci informazioni sui campi in cui aggiungere il tipo di `ReleaseSolution` modifica:
+ `Entity`(oggetto) (obbligatorio): il tipo di entità denominato che viene rilasciato.
+ `Identifier`(string) (required) — L'ID della soluzione.
+ `Type`(string) (richiesto) — Deve essere`Solution@1.0`.
+ `DetailsDocument`(object) (richiesto) — Deve essere un oggetto vuoto. Il tipo di modifica `ReleaseSolution` non accetta alcun dettaglio.
**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 l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `DescribeChangeSet` API.
**Errori asincroni**
Oltre ai [comuni errori asincroni, i seguenti errori](#solution-error-codes) sono specifici delle `ReleaseSolution` azioni nell'API AWS Marketplace Catalog. Questi errori vengono restituiti quando si chiama `DescribeChangeSet` dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo per `DescribeChangeSet` ottenere lo stato di una richiesta di modifica, consulta [Lavorare con i set di modifiche](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| MISSING\_REQUIRED\_FIELDS | Nella richiesta mancano i parametri obbligatori: [%s]. Specificate i valori per tutti i parametri richiesti e riprovate. |
| INCOMPATIBLE\_OPERATION\_RELEASE\_SOLUTION | Il tipo di modifica può essere richiamato solo su Soluzioni con stato Bozza. Aggiorna la visibilità della soluzione su Bozza e riprova. |
## Aggiorna le opzioni di coinvolgimento degli acquirenti
Puoi utilizzare l'API Catalog per configurare il modo in cui gli acquirenti interagiscono con te riguardo alla tua soluzione.
**Nota**
Per utilizzare questo tipo di modifica, devi avere un'iscrizione attiva al programma [APN Customer Engagements](https://aws.amazon.com/partners/programs/ace/) (ACE). È inoltre necessario collegare il proprio account AWS all'account AWS Partner Central registrato ad ACE. Per istruzioni, consulta [Collegamento degli account AWS Partner Central e AWS](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html).
Per aggiornare le opzioni di coinvolgimento degli acquirenti, chiama l'operazione `StartChangeSet` API con il tipo di `UpdateBuyerEngagementOptions` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateBuyerEngagementOptions",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": [
{
"EngagementOption": "RequestProductDemo"
},
{
"EngagementOption": "RequestPrivateOffer"
}
]
}
]
}
```
Fornisci informazioni sui campi per aggiungere il tipo di `UpdateBuyerEngagementOptions` modifica:
+ `Entity`(oggetto) (obbligatorio): il tipo di entità denominato da aggiornare.
+ `Identifier`(string) (richiesto) — L'ID della soluzione.
+ `Type`(string) (richiesto) — Deve essere`Solution@1.0`.
+ `DetailsDocument`(matrice di oggetti) (obbligatorio): le opzioni di coinvolgimento dell'acquirente da abilitare.
+ `EngagementOption`(stringa) (obbligatorio) — Il tipo di opzione di coinvolgimento. Valori validi: `RequestPrivateOffer`, `RequestProductDemo`.
**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.
Per verificare lo stato della richiesta, utilizza l'AWS Marketplace Management Portal o chiama l'`DescribeChangeSet`API.
**Errori asincroni**
Oltre ai [comuni errori asincroni, i seguenti errori](#solution-error-codes) sono specifici delle `UpdateBuyerEngagementOptions` azioni nell'API AWS Marketplace Catalog. Questi errori vengono restituiti quando si chiama `DescribeChangeSet` dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo per `DescribeChangeSet` ottenere lo stato di una richiesta di modifica, consulta [Lavorare con i set di modifiche](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INELIGIBLE\_SELLER | La convalida dell'idoneità ACE non è completa. Per procedere: 1) Collega il tuo account AWS Marketplace al tuo account APN, 2) Completa i requisiti di idoneità ACE. |
## Aggiorna la visibilità della soluzione
Puoi utilizzare l'API Catalog per aggiornare la visibilità di una soluzione in AWS Marketplace.
Puoi impostare la visibilità di destinazione su `Limited``Public`, o. `Restricted`
+ **`Limited`**— La soluzione è completa e il tipo di `ReleaseSolution` modifica è stato completato con successo. In questa visibilità puoi visualizzare in anteprima i dettagli della soluzione sul sito web dell'acquirente. Sul sito web per gli acquirenti di AWS Marketplace, la soluzione è visibile solo all'account proprietario, ai proprietari di ogni prodotto AWS Marketplace incluso nella soluzione e al team AWS Marketplace Seller Operations.
+ **`Public`**— La soluzione è visibile su AWS Marketplace. Gli acquirenti possono visualizzare e interagire con la soluzione.
+ **`Restricted`**— La soluzione non è più visibile al pubblico sul sito web per gli acquirenti di AWS Marketplace.
**Nota**
Per passare alla `Public` visibilità di una soluzione, devi soddisfare i seguenti requisiti:
Devi avere un profilo pubblico su AWS Marketplace.
La soluzione non deve contenere `Public` prodotti diversi.
La soluzione deve avere almeno 2 prodotti `Public` AWS Marketplace.
La soluzione deve avere almeno 1 prodotto AWS Marketplace dallo stesso account AWS.
La soluzione deve avere l'opzione di coinvolgimento `RequestPrivateOffer` dell'acquirente abilitata.
Il team Seller Operations di AWS Marketplace esamina tutte le richieste per portare una soluzione alla `Public` visibilità. Per assistenza, consulta [Ottenere supporto per AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/buyerguide/getting-support.html).
Se lo `TargetVisibility` imposti`Public`, il tipo di `UpdateVisibility` modifica richiede la revisione manuale da parte del team di AWS Marketplace Seller Operations. Ciò aumenta i tempi di esecuzione. Può `UpdateVisibility` essere utilizzato separatamente nel proprio set di modifiche.
Per aggiornare la visibilità della soluzione, richiamate l'operazione `StartChangeSet` API con il tipo di `UpdateVisibility` modifica, come illustrato nell'esempio seguente.
**Sintassi della richiesta**
Per quando `TargetVisibility` è `Public` o`Limited`.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {
"TargetVisibility": "Public"
}
}
]
}
```
Per quando `TargetVisibility` è`Restricted`.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateVisibility",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "soln-1234abcd"
},
"DetailsDocument": {
"TargetVisibility": "Restricted"
}
}
]
}
```
Fornisci informazioni sui campi in cui aggiungere il tipo di `UpdateVisibility` modifica:
+ `Entity`(oggetto) (obbligatorio): il tipo di entità denominato da aggiornare.
+ `Identifier`(string) (richiesto) — L'ID della soluzione.
+ `Type`(string) (richiesto) — Deve essere`Solution@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio): i dettagli necessari per eseguire il set di modifiche.
+ `TargetVisibility`(string) (richiesto) — La nuova visibilità prevista della soluzione. Valori possibili: `Public`, `Limited` e `Restricted`.
**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 l'AWS Marketplace Management Portal o direttamente tramite l'API Catalog utilizzando l'operazione `DescribeChangeSet` API.
Dopo aver attivato questo tipo di modifica con `TargetVisibility` as`Public`, il completamento del processo può richiedere fino a 37 giorni. Ciò include il tempo necessario al Seller Operations Team di AWS Marketplace per esaminare, controllare e approvare.
**Errori asincroni**
I seguenti errori sono specifici `UpdateVisibility` delle azioni nell'API AWS Marketplace Catalog. Questi errori vengono restituiti quando si chiama `DescribeChangeSet` dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo per `DescribeChangeSet` ottenere lo stato di una richiesta di modifica, consulta [Lavorare con i set di modifiche](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_VISIBILITY\_TRANSITION | La soluzione non può essere riportata allo stato Bozza. Una volta rilasciate, le soluzioni possono passare solo dagli stati Limited, Public e Restricted. |
| TOO\_FEW\_USE\_CASES | È necessario almeno un caso d'uso per rendere pubblica una soluzione. Aggiungi un caso d'uso e riprova. |
| TOO\_FEW\_PUBLIC\_PRODUCTS | Sono necessari almeno 2 prodotti AWS Marketplace pubblici per rendere pubblica una soluzione. Aggiungi i prodotti richiesti e riprova. |
| PRODOTTI\_INCOMPATIBILI | La soluzione contiene uno o più prodotti AWS Marketplace non pubblici. Per rendere pubblica la soluzione, rimuovi tutti i prodotti non pubblici e riprova. |
| TOO\_FEW\_SELF\_OWNED\_PRODUCTS | La soluzione richiede almeno un prodotto AWS Marketplace di proprietà del proprietario della soluzione. Aggiungi un prodotto AWS Marketplace dal tuo account e riprova. |
| OPZIONI\_BUYER\_ENGAGEMENT\_INCOMPATIBLE\_BUYER\_ENGAGEMENT\_ | L' RequestPrivateOffer opzione di coinvolgimento dell'acquirente deve essere abilitata per rendere pubblica questa soluzione. Attiva RequestPrivateOffer e riprova. |
| INCOMPATIBLE\_OPERATION\_UPDATE\_VISIBILITY | UpdateVisibility non è supportato per le soluzioni nello stato Bozza. Pubblica la soluzione prima da Draft a Limited using ReleaseSolution, quindi usala UpdateVisibility per passare a Public o Restricted. |
| LIMIT\_EXCEEDED\_TOO\_MANY\_PUBLIC\_SOLUTIONS | Questo account ha raggiunto il limite di 5 soluzioni pubbliche. Aggiorna una soluzione pubblica esistente impostandola su Visibilità limitata o limitata e riprova. |
| MISSING\_SELLER\_PROFILE\_INFORMATION | È necessario un profilo di venditore pubblico per rendere pubbliche le soluzioni. Crea un profilo pubblico nel tuo Account venditore e riprova. |
## Codici di errore asincroni comuni
Esistono alcune convalide asincrone che si applicano a tutti i tipi di modifiche alla soluzione, ad esempio i controlli della validità degli URL e dei caratteri non supportati, e i relativi codici di errore e messaggi di errore sono elencati qui.
Ogni campo URL fornito deve utilizzare il protocollo HTTPS ed essere conforme agli standard RFC2396 o RFC 2732.
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_INPUT | Campo '%s' non valido. Rimuovi i caratteri non supportati %s. |
| INVALID\_INPUT | È stato trovato un contenuto non appropriato «%s» nel campo %s. Fornisci a %s nessun contenuto inappropriato. |
| UNSUPPORTED\_CATALOG | Il catalogo richiesto %s non è supportato da questo tipo di modifica. |
| INVALID\_REMOVE\_OPERATION | Operazione non valida, non è possibile rimuovere %s |
| AUDIT\_ERROR | (varia in base al risultato dell'audit del team AWS Marketplace Seller Operations) |
## Ciclo di vita della soluzione
Le soluzioni progrediscono secondo i seguenti valori di visibilità:
+ `Draft`- Visibilità iniziale dopo la creazione. È possibile aggiungere progressivamente informazioni utilizzando altri tipi di modifica.
+ `Limited`- La soluzione è completa e visibile a te e ai proprietari dei prodotti in anteprima. Puoi ottenere questo risultato utilizzando`ReleaseSolution`.
+ `Public`- La soluzione è visibile a tutti gli acquirenti che navigano sul sito Web di AWS Marketplace. Ciò richiede una convalida aggiuntiva.
+ `Restricted`- La soluzione non è più visibile ai nuovi acquirenti.
**Importante**
Una volta che una soluzione è passata `Draft` alla `Limited` visibilità, non è possibile riportarla a`Draft`. `ReleaseSolution`verifica che tutti i campi obbligatori per una `Limited` soluzione siano presenti prima della transizione alla `Limited` visibilità.
### Requisiti minimi per una soluzione completa
Per creare una soluzione completa e pubblicarla oltre lo stato di bozza, sono necessari i seguenti tipi e attributi di modifica:
+ **`CreateSolution`**: `Name`
+ **`UpdateInformation`**: `Title`, `ShortDescription`, `LongDescription`, `LogoUrl`
+ **`UpdateRelatedProducts`**:`IntegrationDescription`, almeno un elemento in tutto `AwsMarketplaceProducts` e `NonAwsMarketplaceProducts`
+ **`ReleaseSolution`**
L'esempio seguente mostra come creare una soluzione completa con `Limited` visibilità in un unico set di modifiche:
```
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateSolution",
"Entity": {
"Type": "Solution@1.0"
},
"ChangeName": "CreateSolutionChange",
"DetailsDocument": {
"Name": "complete_solution_example",
"Title": "Complete Solution Example"
}
},
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateInformationChange",
"DetailsDocument": {
"ShortDescription": "A comprehensive solution for customer needs",
"LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.",
"LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg",
"UseCases": [
{
"Group": "advertising_and_marketing",
"SubGroup": "ad_intelligence_and_measurement",
"Item": "amazon_ads_insights",
"Description": "Provides comprehensive advertising insights and measurement capabilities"
}
]
}
},
{
"ChangeType": "UpdateRelatedProducts",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateRelatedProductsChange",
"DetailsDocument": {
"AwsMarketplaceProducts": [
{
"ProductId": "prod-123"
}
],
"IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities."
}
},
{
"ChangeType": "UpdateBuyerEngagementOptions",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "UpdateBuyerEngagementChange",
"DetailsDocument": [
{
"EngagementOption": "RequestPrivateOffer"
}
]
},
{
"ChangeType": "ReleaseSolution",
"Entity": {
"Type": "Solution@1.0",
"Identifier": "$CreateSolutionChange.Entity.Identifier"
},
"ChangeName": "ReleaseSolutionChange",
"DetailsDocument": {}
}
]
}
```
## Autorizzazioni IAM per le soluzioni
L'API AWS Marketplace Catalog utilizza autorizzazioni IAM standard. Per ulteriori dettagli, consulta [Controllo degli accessi per l'API AWS Marketplace Catalog](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html).
Puoi utilizzarlo `AWSMarketplaceSellerProductFullAccess` per eseguire tutte le operazioni necessarie per accedere alla soluzione tramite l'API Catalog e Partner Central 3.0 nella Console di gestione AWS.
### Esempio di policy IAM per le soluzioni
Il seguente esempio di policy IAM consente azioni specifiche (`DescribeEntity``ListEntities`, e`StartChangeSet`) sull'`Solution@1.0`entità. Puoi restringere ulteriormente il campo per limitare l'accesso di un'entità principale a determinati tipi di modifiche su determinati ID di entità o ampliarlo per consentire a un'entità principale di operare anche su un altro tipo di entità supportato dall'API Catalog.
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
],
"Condition": {
"StringEquals": {
"catalog:ChangeType": [
"CreateSolution",
"UpdateInformation",
"UpdateRelatedProducts",
"ReleaseSolution",
"UpdateBuyerEngagementOptions",
"UpdateVisibility"
]
}
}
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:ListEntities",
"aws-marketplace:DescribeEntity"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
]
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:DescribeChangeSet",
"aws-marketplace:ListChangeSets",
"aws-marketplace:CancelChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
]
},
{
"Effect": "Allow",
"Action": [
"aws-marketplace:TagResource",
"aws-marketplace:UntagResource",
"aws-marketplace:ListTagsForResource"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
]
}
]
}
```
### Limitazione dell'accesso a soluzioni specifiche
È possibile limitare l'accesso a soluzioni specifiche utilizzando l'ID della soluzione nell'ARN della risorsa:
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123"
]
}
]
}
```
### Limitazione dell'accesso a tipi di modifiche specifici
Puoi limitare l'accesso a tipi di modifiche specifici utilizzando i tasti condizionali:
```
{
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:StartChangeSet"
],
"Resource": [
"arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
],
"Condition": {
"StringEquals": {
"catalog:ChangeType": [
"UpdateInformation",
"UpdateRelatedProducts"
]
}
}
}
]
}
```