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 i prodotti componenti EC2 Image Builder
In qualità di venditore di AWS Marketplace, puoi pubblicare offerte di AMI-based prodotti consegnati agli acquirenti di AWS Marketplace utilizzando i componenti EC2 Image Builder. Per creare il tuo componente e pubblicare un Marketplace AWS elenco, procedi in sequenza attraverso le seguenti sezioni.
**Topics**
+ [Creazione e test del componente Image Builder](#build-and-test-ib-component)
+ [Copiare l'ARN del componente](#ib-copy-component-arn)
+ [Creazione in corso Marketplace AWS Policy IAM](#ib-create-iam-policies)
+ [Creando il Marketplace AWS Ruolo IAM](#ib-create-iam-role)
+ [Preparare l'elenco dei componenti di Image Builder](#prepare-ec2-ib-listing)
+ [Pubblicazione dell'elenco dei prodotti dei componenti Image Builder](#publishing-ib-component-listing)
+ [Aggiornamento delle informazioni sul prodotto del componente Image Builder](#updating-ec2-image-builder-product)
+ [Aggiungere una nuova versione a un prodotto componente Image Builder esistente](#adding-new-ec2-ib-version-existing-product)
+ [Aggiornamento delle informazioni su una versione esistente](#updating-ec2-ib-product-version)
+ [Limitazione di una versione del prodotto componente Image Builder](#restricting-ec2-ib-product-version)
+ [Monitoraggio di un set di modifiche](#monitor-changeset)
+ [Protezione dei download di software](#securing-software-downloads)
## Creazione e test del componente Image Builder
Crea e testa il tuo componente su Image Builder. Per istruzioni, fare riferimento a [Sviluppo di componenti personalizzati per l'immagine di Image Builder nella Guida per l'](https://docs.aws.amazon.com//imagebuilder/latest/userguide/create-custom-components.html)utente di *Image Builder*. Quando create il componente utilizzando Image Builder, assicuratevi di fare quanto segue:
+ Il componente e tutte le sue dipendenze sottostanti, come un bucket Amazon Simple Storage Service (Amazon S3), i segreti o i parametri, devono essere creati nella regione AWS Stati Uniti orientali (Virginia settentrionale) (). `us-east-1`
+ Includi l'architettura supportata e tutte le dipendenze software nella descrizione del componente.
+ Testa il componente nel tuo AWS account creando una [pipeline di immagini](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) e distribuendo l'AMI creata dalla pipeline.
+ Se il componente contiene istruzioni per copiare binari, pacchetti o file da un bucket S3, usa il modulo di azione. `S3Download` Nel `S3Download` modulo, per`source`, inserisci la posizione statica del tuo file nel bucket S3. L'esempio seguente copia un file binario da un bucket S3 come parte dell'installazione del componente.
```
- name: DownloadMyFile
action: S3Download
inputs:
- source: s3://amzn-s3-demo-source-bucket/path/to/package.zip
destination: C:\myfolder\package.zip
```
+ I componenti possono importare file fino a 2 GB quando utilizzano l'azione. `S3Download`
+ Se il componente utilizza [parametri](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-user-defined-variables.html#user-defined-vars-parameters), assicuratevi che tutti i parametri abbiano valori predefiniti. Ad esempio, se avete un parametro denominato`region`, assicuratevi di avere un valore predefinito valido come`us-east-1`. Questi valori predefiniti servono per l' Marketplace AWS elaborazione e il test. Il test potrebbe avere esito negativo se non si includono i valori predefiniti.
+ Se il componente utilizza Gestione dei segreti AWS Parameter Store o una funzionalità di AWS Systems Manager memorizzazione dei parametri, procedi come segue:
+
+ Per recuperare i valori in un unico passaggio nel componente, incorporate AWS Command Line Interface i comandi nel file di configurazione YAML.
+ Crea una voce corrispondente in Secrets Manager o Parameter Store nel tuo AWS account. Utilizzate la chiave predefinita e fornite un valore valido che vi aiuterà a creare il componente durante il processo di Marketplace AWS test. Ad esempio, supponiamo di avere un parametro chiamato `saas_token` con un valore predefinito di `token` che utilizza Parameter Store. In questo caso, create una coppia chiave-valore in Parameter Store. Usa `token` come chiave. Per il valore, inserisci un token SaaS valido per la tua applicazione.
Tieni presente che i valori memorizzati nel tuo Account Marketplace AWS venditore verranno utilizzati solo a scopo di Marketplace AWS test. Questi valori non verranno condivisi con gli acquirenti.
+ Marketplace AWS genera automaticamente Amazon Machine Images (AMI) per il tuo componente in tutte le versioni di sistema operativo compatibili scelte durante il processo di creazione del componente. Quando crei il tuo componente, scegli almeno una versione del sistema operativo compatibile. Convalida la compatibilità del componente con tutte le versioni del sistema operativo scelte utilizzando le pipeline EC2 Image Builder per creare e testare le AMI.
## Copiare l'ARN del componente
Dopo aver creato e testato il componente su Image Builder, copiate e salvate l'ARN del componente. Utilizzerai l'ARN quando pubblicherai l'elenco dei prodotti utilizzando l'API Marketplace AWS Catalog.
**Per copiare l'ARN del componente Image Builder**
1. Accedi alla Console di gestione AWS e apri la console Image Builder all'indirizzo. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)
1. Nella barra di navigazione a sinistra, in **Risorse salvate**, scegli **Componenti**.
1. Nella pagina **Componenti**, per **Proprietario del filtro**, scegli **Di mia proprietà**.
1. Scegli il nome del componente.
1. Nella pagina dei dettagli del componente, nella sezione **Riepilogo**, copia l'ARN.
## Creazione in corso Marketplace AWS Policy IAM
Crea le seguenti policy IAM per concedere Marketplace AWS l'accesso al tuo componente Image Builder e alle risorse correlate come i bucket e i segreti di Amazon S3. Utilizza le politiche di esempio fornite. Associate queste policy a un [ruolo Marketplace AWS IAM](#ib-create-iam-role). Per informazioni sulla creazione di policy, consulta [Creating policies using the JSON editor](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) nella *IAM User Guide*.
+ Politica get-component di Image Builder, per consentire l'accesso Marketplace AWS al componente su Image Builder. Questa politica è obbligatoria. Assegnare un nome alla policy `mp_ib_ingest`.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "imagebuilder:GetComponent",
"Resource": "*"
}
]
}
```
------
+ Politica di accesso in lettura di Amazon S3, per consentire il recupero di file binari Marketplace AWS da un bucket S3. Questa policy è richiesta solo se il componente utilizza il modulo di `S3Download` azione e archivia i file binari associati in un bucket S3. Assegnare un nome alla policy `mp_ib_s3_read_only`.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ListObjectsInBucket",
"Effect": "Allow",
"Action": [
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::{{bucket_name}}"
]
},
{
"Sid": "ReadObjectsInBucket",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectAttributes"
],
"Resource": [
"arn:aws:s3:::{{bucket_name}}/*"
]
}
]
}
```
------
+ Politica di accesso in lettura di Secrets Manager, per consentire di Marketplace AWS recuperare i segreti archiviati in Secrets Manager. Questa politica è richiesta solo se il componente utilizza Secrets Manager per archiviare segreti. Assegnare un nome alla policy `mp_ib_sm_read_only`. Per limitare la politica solo al tuo segreto, sostituisci la `Resource` sezione `*` nella sezione con il tuo segreto.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue"
],
"Resource": [
"*"
]
}
]
}
```
------
+ Politica di accesso in lettura di Parameter Store, Marketplace AWS per consentire il recupero dei segreti archiviati in Parameter Store. Questa politica è richiesta solo se il componente utilizza Parameter Store per archiviare i segreti. Assegnare un nome alla policy `mp_ib_ssm_parameter_read_only`. Per limitare la policy solo al tuo segreto, sostituisci la `Resource` sezione `*` nella sezione con il tuo segreto.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"ssm:getParameter"
],
"Resource": [
"*"
]
}
]
}
```
------
## Creando il Marketplace AWS Ruolo IAM
Utilizza la procedura seguente per creare un ruolo Marketplace AWS IAM con policy per concedere Marketplace AWS l'accesso al componente e alle sue dipendenze.
**Per creare il Marketplace AWS Ruolo IAM**
1. Accedi alla console di AWS gestione e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nella barra di navigazione a sinistra, scegli **Ruoli**.
1. Scegli **Crea ruolo**.
1. Seleziona **Politica di fiducia personalizzata**.
1. Inserisci la seguente dichiarazione:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Principal": {
"Service": "assets.marketplace.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. Scegli **Next (Successivo)**.
1. Aggiungete la policy get-component di Image Builder creata in precedenza. La politica get-component è obbligatoria. Aggiungi le politiche pertinenti per S3, Secrets Manager e Parameter Store se il tuo componente utilizza questi AWS servizi.
1. Scegli **Next (Successivo)**.
1. Inserisci un nome di ruolo, ad esempio`MPEC2IBIngestion`.
1. Scegli **Crea ruolo**.
### Copia Marketplace AWS IAM role ARN (ARN del ruolo IAM)
Dopo aver creato il ruolo Marketplace AWS IAM, copia e salva il ruolo ARN. Utilizzerai l'ARN per pubblicare l'inserzione utilizzando l'API Marketplace AWS Catalog.
**Per copiare il Marketplace AWS IAM role ARN (ARN del ruolo IAM)**
1. Nella console IAM, nella barra di navigazione a sinistra, scegli **Ruoli**.
1. Scegli il ruolo Marketplace AWS IAM che hai creato in precedenza, ad esempio`MPEC2IBIngestion`.
1. Nella pagina dei dettagli del ruolo, nella sezione **Riepilogo**, copia l'ARN.
## Preparare l'elenco dei componenti di Image Builder
Prima di pubblicare l' Marketplace AWS inserzione, assicurati di avere a portata di mano le seguenti informazioni:
+ **Metadati del prodotto:** i metadati includono il logo del prodotto, il titolo del prodotto, il contratto di licenza con l'utente finale, i tipi di istanze supportati e la regione AWS.
+ **Informazioni sui prezzi:** puoi offrire il tuo prodotto gratuitamente, a una tariffa oraria o a una tariffa oraria con un periodo di prova gratuito iniziale. La licenza Bring your own (BYOL) non è supportata.
+ **Dettagli del componente:** i dettagli includono il componente Amazon Resource Number (ARN), i dettagli sull'utilizzo e il ruolo AWS Identity and Access Management (IAM) che Marketplace AWS assumerà per elaborare il componente.
## Pubblicazione dell'elenco dei prodotti dei componenti Image Builder
Questo argomento contiene le istruzioni per pubblicare l' Marketplace AWS elenco dei componenti EC2 Image Builder sull' Marketplace AWS utilizzo dell'API Catalog.
### Prerequisiti
Assicuratevi di disporre di quanto segue prima di pubblicare l'elenco dei componenti Image Builder:
+ Registrazione come venditore in Marketplace AWS. Per ulteriori informazioni, consulta [Registrati come venditore di AWS Marketplace](https://catalog.workshops.aws/mpseller/en-US/pre-requisite-register-as-seller).
+ Un utente IAM con `AWSMarketplaceSellerFullAccess` autorizzazione.
+ Un bucket Amazon Simple Storage Service (Amazon S3) S3) accessibile pubblicamente per ospitare il logo e l'EULA della tua azienda, se utilizzato nel tuo componente. Inserirai l'URL del bucket S3 nel tuo file JSON. `ChangeSet`
+ AWS Command Line Interface ().AWS CLI Per ulteriori informazioni, consulta [Cos'è l'interfaccia a riga di comando di AWS?](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) nella *Guida AWS Command Line Interface per l'utente*.
### Creazione di un prodotto componente Image Builder su Marketplace AWS
Per creare un Marketplace AWS prodotto componente EC2 Image Builder sull'utilizzo dell'API Catalog, consulta. [Crea un prodotto](work-with-seller-products.md#create-product)
## Aggiornamento delle informazioni sul prodotto del componente Image Builder
È possibile aggiornare le informazioni su un prodotto componente Image Builder sul portale di Marketplace AWS gestione.
**Per aggiornare le informazioni sul prodotto dei componenti Image Builder**
1. Apri [Portale di gestione Marketplace AWS](https://aws.amazon.com/marketplace/management/tour/)e accedi al tuo Account venditore.
1. Nel menu **Prodotti**, scegli **Server**.
1. Nella pagina **dei prodotti Server**, seleziona il prodotto.
1. Nella pagina dei dettagli del prodotto, nel menu **Richiedi modifiche**, scegli la voce che corrisponde alle informazioni che desideri aggiornare.
1. Dopo aver inviato le modifiche, la richiesta verrà visualizzata nella scheda **Richieste** con lo stato «In corso di revisione» e, una volta completata, diventerà «Operata con successo».
## Aggiungere una nuova versione a un prodotto componente Image Builder esistente
È possibile aggiungere una nuova versione a un prodotto componente Image Builder Marketplace AWS utilizzando il. AWS Marketplace Catalog API
**Per aggiungere una nuova versione**
1. Da Portale di gestione Marketplace AWS, ottieni l'ID del prodotto.
1. Apri [Portale di gestione Marketplace AWS](https://aws.amazon.com/marketplace/management/tour/)e accedi al tuo Account venditore.
1. Nel menu **Prodotti**, scegli **Server**.
1. Nella pagina **dei prodotti Server**, seleziona il prodotto.
1. Nel **riepilogo del prodotto**, copia l'**ID del prodotto**.
1. Utilizzando il seguente esempio di codice, create un file changeset in formato JSON. Nell'esempio, sostituiscilo {{your-product-ID}} con l'ID del prodotto ottenuto nel passaggio 1. {{new-version-name}}Sostituiscilo con il titolo della tua versione. {{new-delivery-option-title}}Sostituiscilo con il titolo dell'opzione di spedizione.
```
[
{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Identifier": "{{your-product-ID}}",
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "{{new-version-name}}",
"ReleaseNotes": "Release notes goes here."
},
"DeliveryOptions": [
{
"DeliveryOptionTitle": "{{new title}}",
"Details": {
"Ec2ImageBuilderComponentDeliveryOptionDetails": {
"UsageInstructions": "Test usage instructions for IB",
"AccessRoleArn": "arn:aws:iam::123456789:role/sample",
"ComponentArn": "arn:aws:imagebuilder:us-east-1:123456789:component/sample/2.0.0/1"
}
}
}
]
}
}
]
```
1. Salva il file del changeset con il nome. `addIBversion.json`
1. Nel tuo terminale oppure AWS CloudShell esegui il seguente comando:
```
aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://addIBversion.json
```
Il `start-change-set` comando restituirà un `ChangeSetId` valore. Per monitorare un set di modifiche, vedere[Monitoraggio di un set di modifiche](#monitor-changeset).
**Errori asincroni**
I seguenti errori sono specifici `AddDeliveryOptions` delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama `DescribeChangeSet` dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo `DescribeChangeSet` per ottenere lo stato di una richiesta di modifica, vedere[Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets).
**Nota**
I seguenti codici di errore sono specifici del metodo di consegna Image Builder. Per i messaggi di errore esistenti in campi come `Usage Instructions``Recommended Instance type`, e`AccessRoleArn`, vedi[Aggiungi una nuova versione](work-with-single-ami-products.md#ami-add-version).
| Codice di errore | Messaggio di errore |
| --- | --- |
| ASSET\_NOT\_FOUND | Controlla se [component arn] esiste nell' AWS account [account-id] e l'accessARN fornito [ARN] dispone delle autorizzazioni per condividere questo componente Image Builder. Marketplace AWS |
| ASSET\_NOT\_FOUND | Il link S3 specificato [x] all'interno del componente [x] non esiste. Fornisci un link S3 valido all'interno del componente. |
| NOME\_COMPONENTE DUPLICATO | Il nome del componente [x] esiste già nella stessa versione. Fornisci un nome diverso per il componente. |
| NOME\_COMPONENTE DUPLICATO | Il nome del componente [x] che hai fornito è già utilizzato da un altro prodotto. Fornisci un nome diverso per il componente. |
| DUPLICATE\_COMPONENT\_ARN | Il componente Arn [x] deve essere diverso dal Component Arn utilizzato in altre opzioni di consegna della stessa versione di questo prodotto. |
| DUPLICATE\_COMPONENT\_ARN | Il componente ARN [x] deve essere diverso dall'ARN del componente utilizzato in altre versioni di questo prodotto. |
| SCAN\_ERROR | Risolve la vulnerabilità di sicurezza [y] su Component [x]. |
| ASSET\_ACCESS\_EXCEPTION | Non disponiamo delle autorizzazioni necessarie per leggere i contenuti dal bucket S3 specificato [x]. Assicurati che il bucket S3 disponga delle autorizzazioni di lettura appropriate. |
| ASSET\_ACCESS\_EXCEPTION | Non disponiamo delle autorizzazioni necessarie per leggere il contenuto del componente ARN [x] specificato. Assicurati che l'ARN del componente disponga delle autorizzazioni di lettura appropriate. |
| ASSET\_ACCESS\_EXCEPTION | Non disponiamo delle autorizzazioni necessarie per leggere il contenuto dell'URI del pacchetto specificato [x]. Assicurati che l'URI del pacchetto disponga dei permessi di lettura appropriati. |
| ASSET\_ACCESS\_EXCEPTION | Impossibile leggere dalla fonte HTTP [x]. Verificate che l'origine HTTP fornita sia corretta. |
| PACCHETTO\_IMAGE\_BUILDER\_COMPONENT\_INVALID\_IMAGE\_ | Le risorse dei componenti superano il limite di dimensione per l'ingestione. Riduci le dimensioni dei S3/web download o elimina i download non necessari per procedere. |
| PACCHETTO\_IMAGE\_BUILDER\_COMPONENT\_COMPONENTE NON VALIDO | Le risorse dei componenti impiegano troppo tempo per essere assimilate. Assicurati che la connessione di rete sia stabile e disponga di una larghezza di banda adeguata. |
| TOO\_MANY\_IMAGE\_BUILDER\_COMPONENTS | Sono supportati un massimo di 5 nomi di componenti univoci per prodotto, limita l'opzione di consegna aggiuntiva. |
| PROFILO\_SELLER\_PUBBLICO\_INCOMPLETO | Il tuo profilo pubblico di venditore non è completo. Completa il tuo profilo pubblico prima di aggiungere versioni al prodotto. |
| DESCRIZIONE\_NON VALIDA | Manca la descrizione. Fornisci una descrizione con meno di 1024 caratteri nel componente [x]. |
| NOME\_COMPONENTE NON VALIDO | Fornisci un nome di componente con meno di [x] caratteri. |
| VERSIONE\_OS\_SUPPORTATA NON VALIDA | Manca la versione del sistema operativo. Fornisci una versione del sistema operativo supportata valida in component [x]. |
| INVALID\_PATH\_FORMAT | Al passaggio [STEP\_NAME] nella fase [PHASE\_NAME] non è consentito utilizzare S3 o URL Web per le azioni. InstallMSI/UninstallMSI Assicurati che il percorso specificato sia un percorso locale valido accessibile dal sistema che esegue l'azione. |
| TIPO\_OS\_INCOMPATIBILE | Il tipo di sistema operativo del componente specificato [x] non è compatibile con la piattaforma dell'immagine di base. Fornisci un tipo di sistema operativo compatibile con l'immagine di base. |
| ASSET\_ACCESS\_EXCEPTION | Non disponiamo delle autorizzazioni necessarie per leggere il contenuto del parametro SSM specificato [x]. Assicurati che il ruolo di accesso IAM fornito nell'input dell'API disponga delle autorizzazioni di lettura richieste. |
| ASSET\_ACCESS\_EXCEPTION | Non disponiamo delle autorizzazioni necessarie per leggere i contenuti del segreto specificato [x]. SecretsManager Assicurati che il ruolo di accesso IAM fornito nell'input dell'API disponga delle autorizzazioni di lettura richieste. |
| INVALID\_IB\_COMPONENT\_BUILD\_VERSION | Il componente ARN [x] ha una versione build di [y]. Marketplace AWS supporta solo la versione di build 1. Crea una nuova versione di EC2 Image Builder con la versione Build 1 e riprova Marketplace AWS |
| INVALID\_IB\_COMPONENT\_PARAMETER | Impossibile analizzare il parametro SSM nell'input [x] per il componente [y]. |
| PARAMETRO\_IB\_COMPONENT\_INVALID\_ | Impossibile analizzare il SecretsManager segreto nell'input [x] per il componente [y]. |
| PARAMETRO\_IB\_COMPONENT\_MANCANTE | Parametro non trovato nel componente [x] per l'input [y] |
| PARAMETRO\_IB\_COMPONENT\_INVALID\_ | Fornite un valore predefinito per il parametro [x] nel componente [y]. |
| FAILED\_LAUNCH\_TEST | Il test di avvio per il componente [x] non è riuscito. Messaggio di errore: [z] |
| SSHAuthFailedForUserAndKeypair | Impossibile accedere all'istanza con il nome utente predefinito del sistema operativo [X]. |
| INVALID\_IB\_COMPONENT | È richiesta una fase di creazione del componente. Aggiungi una fase di compilazione valida al componente [x] |
| DUPLICATE\_VERSION\_TITLE | Il titolo della versione deve essere diverso da qualsiasi altro titolo di versione di questo prodotto. |
| INVALID\_VERSION\_TITLE | Rimuovi gli spazi prima del simbolo del marchio. |
| INVALID\_VERSION\_TITLE | Rimuovi caratteri non supportati: [x, y, z] |
| TITOLO\_VERSIONE NON VALIDA | Rimuovi gli spazi dall'inizio del titolo della versione. |
| INVALID\_VERSION\_TITLE | Fornisci il titolo della versione con meno di [x] caratteri. |
| INVALID\_RELEASE\_NOTES | Rimuovi gli spazi prima del simbolo del marchio. |
| INVALID\_RELEASE\_NOTES | Rimuovi caratteri non supportati: [x, y, z] |
| NOTE\_DI RILASCIO NON VALIDE | Rimuovi gli spazi dall'inizio delle note di rilascio. |
| INVALID\_RELEASE\_NOTES | Fornisci note di rilascio con meno di (x) caratteri. |
| ISTRUZIONI\_UTILIZZO\_NON VALIDE | Rimuovi gli spazi prima del simbolo del marchio. |
| INVALID\_USAGE\_INSTRUCTIONS | Rimuovi caratteri non supportati: [x, y, z] |
| ISTRUZIONI\_UTILIZZO\_NON VALIDE | Fornisci istruzioni d'uso con meno di (x) caratteri. |
| DUPLICATE\_DELIVERY\_OPTION\_TITLES | Fornisci un titolo univoco per l'opzione di consegna. |
| INVALID\_DELIVERY\_OPTION\_TITLES | Il titolo dell'opzione di consegna esiste già, riprova con un titolo diverso. |
## Aggiornamento delle informazioni su una versione esistente
**Per aggiornare le informazioni su una versione esistente**
1. Da Portale di gestione Marketplace AWS, ottieni l'ID del prodotto.
1. Apri [Portale di gestione Marketplace AWS](https://aws.amazon.com/marketplace/management/tour/)e accedi al tuo Account venditore.
1. Nel menu **Prodotti**, scegli **Server**.
1. Nella pagina **dei prodotti Server**, seleziona il prodotto.
1. Nel **riepilogo del prodotto**, copia l'**ID del prodotto**.
1. Nel tuo terminale, esegui il seguente comando. Nel comando, {{your-product-ID}} sostituiscilo con l'ID ottenuto nel passaggio 1.
```
aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id '{{your-product-ID}}'
```
1. Nell'output restituito, vai alla `Versions` sezione`DetailsDocument`,. Copia il `Id` valore`DeliveryOptions`, per la versione che desideri aggiornare.
1. Utilizzando il seguente esempio di codice, create un file changeset in formato JSON. Nell'esempio, sostituiscilo {{your-product-ID}} con l'ID del prodotto ottenuto nel passaggio 1. {{your-release-notes}}Sostituiscilo con le tue note di rilascio. Sostituisci {{your-delivery-option-ID}} con l'ID dell'opzione di spedizione che hai ottenuto nel passaggio 3. {{your-usage-instructions}}Sostituiscilo con le tue istruzioni per l'uso.
```
[
{
"ChangeType": "UpdateDeliveryOptions",
"Entity": {
"Identifier": "{{your-product-ID}}",
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {
"Version": {
"ReleaseNotes": "{{your-release-notes}}"
},
"DeliveryOptions": [
{
"Id": "{{your-delivery-option-ID}}",
"Details": {
"Ec2ImageBuilderComponentDeliveryOptionDetails": {
"UsageInstructions": "{{your-usage-instructions}}"
}
}
}
]
}
}
]
```
1. Salva il file del changeset con il nome. `updateVersionInfo.json`
1. Nel tuo terminale oppure AWS CloudShell, esegui il seguente comando:
```
aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://updateVersionInfo.json
```
Il `start-change-set` comando restituirà un `ChangeSetId` valore. Per monitorare un set di modifiche, vedere[Monitoraggio di un set di modifiche](#monitor-changeset).
## Limitazione di una versione del prodotto componente Image Builder
La limitazione di una versione la rende non disponibile per gli acquirenti. È possibile limitare l' Marketplace AWS utilizzo dell'API Marketplace AWS Catalog per una versione del prodotto componente Image Builder. È necessario mantenere illimitata l'utilizzo di almeno una versione del prodotto. Marketplace AWS Non puoi limitare l'accesso all'unica versione pubblica.
**Per aggiornare le informazioni su una versione esistente**
1. Da Portale di gestione Marketplace AWS, ottieni l'ID del prodotto.
1. Apri [Portale di gestione Marketplace AWS](https://aws.amazon.com/marketplace/management/tour/)e accedi al tuo Account venditore.
1. Nel menu **Prodotti**, scegli **Server**.
1. Nella pagina **dei prodotti Server**, seleziona il prodotto.
1. Nel **riepilogo del prodotto**, copia l'**ID del prodotto**.
1. Nel tuo terminale, esegui il seguente comando. Nel comando, {{your-product-ID}} sostituiscilo con l'ID ottenuto nel passaggio 1.
```
aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id '{{your-product-ID}}'
```
1. Nell'output restituito, vai alla `Versions` sezione`DetailsDocument`,. Copia il `Id` valore`DeliveryOptions`, per la versione che desideri aggiornare.
1. Utilizzando il seguente esempio di codice, create un file changeset in formato JSON. Nell'esempio, sostituiscilo {{your-product-ID}} con l'ID del prodotto ottenuto nel passaggio 1. Sostituiscilo {{your-delivery-option-ID}} con l'ID dell'opzione di spedizione che hai ottenuto nel passaggio 3.
```
[
{
"ChangeType": "RestrictDeliveryOptions",
"Entity": {
"Identifier": "{{your-product-ID}}",
"Type": "AmiProduct@1.0"
},
"DetailsDocument": {
"DeliveryOptionIds": [
"{{your-delivery-option-ID}}"
]
}
}
]
```
1. Salva il file changeset con il nome. `restrictec2ibversion.json`
1. Nel tuo terminale oppure AWS CloudShell, esegui il seguente comando:
```
aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://restrictec2ibversion.json
```
Il `start-change-set` comando restituirà un `ChangeSetId` valore. Per monitorare un set di modifiche, vedere[Monitoraggio di un set di modifiche](#monitor-changeset).
## Monitoraggio di un set di modifiche
Il `start-change-set` comando restituirà un `ChangeSetId` valore. È possibile monitorare l'avanzamento del set di modifiche nei seguenti modi:
+ Esegui il seguente comando nel tuo terminale. Nel comando. sostituisci {{changeset-ID}} con il `ChangeSetId` valore restituito dal `start-change-set` comando.
```
aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-id {{changesetID}}
```
+ Visualizza lo stato della richiesta nella scheda **Richieste** del [portale di Marketplace AWS gestione](https://aws.amazon.com/marketplace/management/).
## Protezione dei download di software
Per salvaguardare la proprietà intellettuale del software ISV e garantire una distribuzione stabile e coerente del software agli Marketplace AWS acquirenti, analizza `S3Download` e aziona Marketplace AWS automaticamente i moduli del `WebDownload` componente. I file di riferimento vengono quindi archiviati in modo sicuro in un bucket Amazon S3 privato gestito da. Marketplace AWS Per disattivare questo processo di inserimento e gestire i download di software in modo indipendente, esegui script bash che utilizzano i comandi o download. `wget` `curl`