View a markdown version of this page

Lavora con soluzioni - AWS Marketplace
Soluzioni in AWS Marketplace e AWS Partner CentralEntità della soluzioneGuida introduttiva alle soluzioniElenca le tue soluzioniOttieni i dettagli della soluzioneElenca la cronologia delle modifiche per una soluzioneContrassegna le soluzioni e i set di modificheCrea una soluzioneAggiorna le informazioni sulla soluzioneAggiorna i prodotti correlatiRilascia una soluzioneAggiorna le opzioni di coinvolgimento degli acquirentiAggiorna la visibilità della soluzioneCodici di errore asincroni comuniCiclo di vita della soluzioneAutorizzazioni IAM per le soluzioni

L'AWS Marketplace API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Marketplace API Reference.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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. 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.

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), 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.

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 dell'API AWS Marketplace Catalog.

Prima di iniziare, assicurati di avere:

Elenca le tue soluzioni

Per elencare tutte le soluzioni presenti nel tuo account, chiama l'ListEntitiesoperatore 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'DescribeEntityAPI.

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.

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 e Aggiungere tag a un'entità e modificare il set durante la creazione.

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), eReleaseSolution. 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 essereSolution@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 eChangeSetArn:

{
  "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'DescribeChangeSetAPI.

Quando la richiesta viene completata con successo (se lo Status èSUCCEEDED), viene generato un nuovo ID della soluzione.

Errori asincroni

CreateSolutionle azioni restituiscono errori specifici, oltre ai comuni 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.

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'StartChangeSetoperatore 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 inDetailsDocument, il flusso di lavoro convalida l'input e sovrascrive i valori esistenti.

  • Se un campo di primo livello non è presente inDetailsDocument, 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 essereSolution@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.

    • 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.

      • Type(string) (obbligatorio) — Image OVideo.

      • 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 per i valori attivi accettati e le relative etichette di introduzione. 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.

      • 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.

      • Item(stringa) — Caso d'uso specifico. Deve essere uno dei valori dell'articolo nell'elenco delle categorie dei casi d'uso.

      • 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 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 aLimited, è necessario impostare correttamente i seguenti campi:Title, ShortDescriptionLongDescription, eLogoUrl.

Tuttavia, quando si aggiornano i campi esistenti sulla soluzione, è possibile includere solo gli attributi che devono essere modificati nell'DetailsDocumentoggetto del tipo di UpdateInformation modifica.

Sintassi della risposta

Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'ChangeSetIde ChangeSetArn per il set di modifiche ed è simile alla seguente.

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Per verificare lo stato della richiesta, utilizza l'AWS Marketplace Management Portal o chiama l'DescribeChangeSetAPI.

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 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.

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.

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 seguitoUpdateRelatedProducts.

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 essereSolution@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 conprod-). 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: SoftwareConsulting,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'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.

Per verificare lo stato della richiesta, utilizza l'AWS Marketplace Management Portal o chiama l'DescribeChangeSetAPI.

Errori asincroni

Oltre ai comuni errori asincroni, i seguenti errori 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.

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

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

La richiesta di modifica viene aggiunta a una coda ed elaborata. Puoi controllare lo stato della richiesta tramite 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 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.

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 (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.

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 essereSolution@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'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.

Per verificare lo stato della richiesta, utilizza l'AWS Marketplace Management Portal o chiama l'DescribeChangeSetAPI.

Errori asincroni

Oltre ai comuni errori asincroni, i seguenti errori 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.

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 LimitedPublic, 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.

Se lo TargetVisibility impostiPublic, 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 oLimited.

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

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

La richiesta di modifica viene aggiunta a una coda ed elaborata.

Puoi controllare lo stato della richiesta tramite 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 asPublic, 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.

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 utilizzandoReleaseSolution.

  • 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 aDraft. ReleaseSolutionverifica 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.

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 (DescribeEntityListEntities, eStartChangeSet) sull'Solution@1.0entità. 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"
          ]
        }
      }
    }
  ]
}