L'API Reference di AWS Marketplace è 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 AMI-based i prodotti
Puoi utilizzarlo AWS Marketplace Catalog API per automatizzare le attività per lavorare con prodotti basati su Amazon Machine Image (AMI).
Per informazioni sulla creazione di un AMI-based prodotto utilizzando l'API Catalog, consulta[Crea un prodotto](work-with-seller-products.md#create-product).
I seguenti argomenti descrivono come utilizzare l'API del catalogo per eseguire azioni sui tuoi AMI-based prodotti:
**Topics**
+ [Aggiungi una nuova versione](#ami-add-version)
+ [Aggiorna le informazioni sulla versione](#ami-update-version)
+ [Limita una versione](#ami-restrict-version)
+ [Aggiornamento futuro Regione AWS supporto](#update-future-region-support)
+ [Aggiungi un supporto Regione AWS](#add-regions)
+ [Limita un Regione AWS](#restrict-regions)
+ [Aggiungere un nuovo tipo di istanza](#add-instance-types)
+ [Limita un tipo di istanza](#restrict-instance-types)
## Aggiungi una nuova versione
Puoi utilizzare l'API del catalogo per aggiungere una nuova versione a un AMI-based prodotto esistente in Marketplace AWS. Per ulteriori informazioni sull'aggiunta di nuove versioni AMI al prodotto utilizzando il Portale di gestione Marketplace AWS, consulta [ Aggiungere una nuova versione ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-adding-version) nella Guida per il *Marketplace AWS venditore*.
Quando si crea una richiesta che include l'aggiunta di una nuova AMI ad AWS Marketplace, l'AMI deve essere copiata nel sistema AWS Marketplace e quindi analizzata per individuare eventuali problemi di sicurezza. Devi concedere ad AWS Marketplace l'accesso all'AMI creando un ruolo AWS Identity and Access Management (IAM) con le autorizzazioni per eseguire azioni sulla tua AMI. Per ulteriori informazioni sulle autorizzazioni richieste, consulta Consentire ad AWS [ Marktplace l'accesso alla tua AMI ](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-marketplace-ami-access.html) nella Seller Guide. *Marketplace AWS *
Per aggiungere una nuova versione, richiama l'operazione `StartChangeSet` API con il tipo di `AddDeliveryOptions` modifica per AMI-based i prodotti, come mostrato nell'esempio seguente. Per testare la chiamata API senza creare effettivamente una nuova versione, imposta il `Intent` parametro su`VALIDATE`. Per ulteriori informazioni, consulta [ Intent. ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_StartChangeSet.html#API_StartChangeSet_RequestBody)
**Nota**
Per i prodotti AMI, una versione è composta da una o più opzioni di consegna. Tutte le opzioni di consegna nella stessa versione devono avere lo stesso `AmiSource` oggetto con gli stessi dettagli. Tutte le opzioni di consegna devono essere aggiunte a una versione al momento della creazione della versione. Non è possibile aggiungere opzioni di spedizione a una versione esistente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "AddDeliveryOptions",
"Entity":
{
"Type": "AmiProduct@1.0",
"Identifier": "prod-example12345"
},
"DetailsDocument":
{
"Version":
{
"VersionTitle": "My new title",
"ReleaseNotes": "My new Release notes"
},
"DeliveryOptions":
[
{
"Details":
{
"AmiDeliveryOptionDetails":
{
"AmiSource":
{
"AmiId": "ami-1234567890abcdef",
"AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceAmiIngestion",
"UserName": "ec2-user",
"OperatingSystemName": "AMAZONLINUX",
"OperatingSystemVersion": "Amazon Linux 2 AMI 2.0.20210126.0 x86_64 HVM gp2",
"AfiIds": ["afi-1234567890abcdefg", "afi-abcdefg1234567890"] //Optional (Required only for FPGA products)
},
"UsageInstructions": "Easy to use AMI",
"RecommendedInstanceType": "m4.xlarge",
"SecurityGroups":
[
{
"IpProtocol": "tcp",
"FromPort": 443,
"ToPort": 443,
"IpRanges":
[
"0.0.0.0/0"
]
}
]
}
}
},
{
"DeliveryOptionTitle": "My new AMI with CFTdelivery option",
"Details":
{
"DeploymentTemplateDeliveryOptionDetails":
{
"ShortDescription": "My new short description",
"LongDescription": "My new long description",
"UsageInstructions": "My new usage instructions",
"RecommendedInstanceType": "m4.xlarge",
"ArchitectureDiagram": "https://my-bucket.s3.amazonaws.com/my-folder/diagram.png",
"Template": "https://my-bucket.s3.amazonaws.com/my-folder/cft.template",
"TemplateSources":
[
{
"ParameterName": "MyAmiParam",
"AmiSource":
{
"AmiId": "ami-1234567890abcdef",
"AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceAmiIngestion",
"UserName": "ec2-user",
"OperatingSystemName": "AMAZONLINUX",
"OperatingSystemVersion": "Amazon Linux 2 AMI 2.0.20210126.0 x86_64 HVM gp2"
}
}
]
}
}
}
]
}
}
],
"Intent": "APPLY"
}
```
L'elenco seguente fornisce informazioni sui campi di input utilizzati per il tipo di `AddDeliveryOptions` modifica. Tutti i campi sono obbligatori se non diversamente specificato. Per ulteriori informazioni su questi campi, consulta [ Aggiungere una nuova versione ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-adding-version) nella Guida per il Marketplace AWS venditore.
+ **DeliveryOptions**(serie di oggetti): un elenco di oggetti per le opzioni di consegna, inclusi i dettagli di ciascuno. È necessario includerne almeno uno.
+ Per l'opzione di * consegna * AMI (autonoma), specifica un oggetto con i seguenti dettagli. Puoi avere una sola opzione di consegna con questo tipo.
+ **Dettagli ** (oggetto): contiene i dettagli di questa opzione di consegna. Nota che questo oggetto di dettagli annidato non deve essere sottoposto a un doppio escape.
+ **AmiDeliveryOptionDetails**(oggetto) — Utilizzato per fornire i dettagli di ciascuna opzione di consegna AMI.
+ **AmiSource**(oggetto) — Dettagli sull'AMI da utilizzare per la versione aggiunta.
+ **AmiId**(string) — ID dell'AMI di origine, situato nel Regione AWS punto in cui viene chiamata l'API. Deve sempre essere Stati Uniti orientali (Virginia settentrionale) perché è l'unica regione in cui è disponibile l'API del catalogo. Deve appartenere all'account del chiamante.
+ **AccessRoleArn**(stringa) — Ruolo IAM Amazon Resource Name (ARN) utilizzato Marketplace AWS per accedere all'AMI fornita. Per informazioni dettagliate sulla creazione e l'utilizzo di questo ARN, consulta [ Dare ad AWS Marketplace l'accesso alla tua AMI ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-marketplace-ami-access) nella *Marketplace AWS Seller Guide. *
+ **UserName**(string) — Nome utente di login per accedere al sistema operativo (OS) nell'AMI. In genere ec2-user per le AMI Linux o Administrator per Windows.
+ **ScanningPort**(numero intero) — Porta SSH o RDP utilizzata per accedere al sistema operativo. Utilizzata per la scansione dell'AMI fornita alla ricerca di vulnerabilità di sicurezza. Il valore predefinito è 22.
+ **OperatingSystemName**(stringa) — Nome del sistema operativo visualizzato dagli acquirenti.
+ **OperatingSystemVersion**(string) — Stringa della versione del sistema operativo visualizzata dagli acquirenti.
+ **AfiIds**(matrice di stringhe) (opzionale) — ID Amazon FPGA Image (AFI) per abilitare il supporto FPGA per questa versione. Se fornito, ciò consente al prodotto di funzionare su tipi di istanze F2. FPGA-enabled È possibile fornire fino a 15 ID AFI per versione. Tutti gli ID AFI che fornisci devono provenire dalla regione Stati Uniti orientali (Virginia settentrionale), risiedere nel tuo account venditore AWS Marketplace e il ruolo di accesso IAM fornito deve avere le autorizzazioni per condividere questa AFI con AWS Marketplace. Per maggiori dettagli sulle autorizzazioni richieste, consulta [ Dare ad AWS Marketplace l'accesso alle tue immagini FPGA ](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-marketplace-ami-access.html#single-ami-marketplace-afi-access) nella Guida per i venditori. *Marketplace AWS *
+ **UsageInstructions**(string) — Istruzioni per l'uso dell'AMI o un link a ulteriori informazioni sull'AMI.
+ **AccessEndpointUrl**(object) (opzionale) — Utilizzato per creare un percorso di accesso all'AMI dopo il suo utilizzo.
+ **Porta ** (stringa): il numero di porta utilizzato per accedere al servizio in esecuzione sull'AMI.
+ **Protocollo ** (stringa): il protocollo (http o https) utilizzato per accedere al servizio in esecuzione sull'AMI.
+ **RelativePath**(stringa) — Il percorso dalla radice web per accedere al servizio in esecuzione sull'AMI (ad esempio /index.html).
+ **RecommendedInstanceType**(string) — Il tipo di istanza consigliato per eseguire il servizio con l'AMI ed è l'impostazione predefinita per le installazioni del servizio con 1 clic. Per un elenco dei tipi di istanza, consulta la sezione Tipi di [ istanza ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) nella * Amazon Elastic Compute Cloud User Guide for Linux Instances. *
+ **SecurityGroups**(array di oggetti): un elenco di oggetti che rappresentano le regole di ingresso per i gruppi creati automaticamente per la versione.
+ **IpProtocol**(string) — Il protocollo da usare (tcp o udp).
+ **FromPort**(intero) — La porta di origine.
+ **ToPort**(numero intero) — La porta di destinazione.
+ **IpRanges**(matrice di stringhe) — Intervalli IP da consentire, in formato CIDR (nel formato xxx.xxx.xxx. xxx/nn, ad esempio,). {{192.0.2.0/24}}
+ Per * AMI con opzione CloudFormation * di consegna, specifica un oggetto con i seguenti dettagli. Puoi avere fino a tre opzioni di consegna di questo tipo.
+ **DeliveryOptionTitle**(stringa) — Titolo per l'opzione di consegna.
+ **Dettagli ** (oggetto): contiene i dettagli di un'opzione di consegna AMI. Nota che questo oggetto di dettagli annidato non ha bisogno di un doppio escape.
+ **DeploymentTemplateDeliveryOptionDetails**(oggetto) — Utilizzato per fornire i dettagli di ciascuna opzione di consegna CFT.
+ **ShortDescription**(string) — Breve descrizione dell'opzione di consegna del CloudFormation modello.
+ **LongDescription**(string) — Descrizione dettagliata dell'opzione di consegna del CloudFormation modello.
+ **UsageInstructions**(string) — Istruzioni per l'uso dell'AMI o un link a ulteriori informazioni sull'AMI.
+ **RecommendedInstanceType**(string) — Il tipo di istanza consigliato per eseguire il servizio con l'AMI ed è quello predefinito per le installazioni del servizio con 1 clic. Per un elenco dei tipi di istanza, consulta la sezione Tipi di [ istanza ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) nella * Amazon Elastic Compute Cloud User Guide for Linux Instances. *
+ **ArchitectureDiagram**(string) — URL della posizione del diagramma architettonico in Amazon S3.
+ **Modello ** (stringa): URL della posizione del CloudFormation modello in Amazon S3.
+ **TemplateSources**(serie di oggetti)
+ **ParameterName**(stringa) — Nome del parametro nel CloudFormation modello a cui deve essere passata l'AMI in questa versione. Per ulteriori informazioni, consulta [ i dettagli sui requisiti per l'AMI](https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation.html#ami-requirements-sse).
+ **AmiSource**(oggetto)
+ **AmiId**(stringa) — ID dell'AMI di origine, situato nel luogo in Regione AWS cui viene chiamata l'API (attualmente deve essere sempre Stati Uniti orientali (Virginia settentrionale) perché è l'unica regione in cui è disponibile l'API del catalogo). Deve appartenere all'account del chiamante.
+ **AccessRoleArn**(stringa) — Ruolo IAM Amazon Resource Name (ARN) utilizzato Regione AWS per accedere all'AMI fornita. Per informazioni dettagliate sulla creazione e l'utilizzo di questo ARN, consulta [ Dare ad AWS Marketplace l'accesso alla tua AMI ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-marketplace-ami-access) nella *Marketplace AWS Seller Guide. *
+ **UserName**(string) — Nome utente di login per accedere al sistema operativo (OS) nell'AMI. In genere `ec2-user` per le AMI Linux o `Administrator` per Windows.
+ **OperatingSystemName**(stringa) — Nome del sistema operativo visualizzato agli acquirenti.
+ **OperatingSystemVersion**(string) — Stringa della versione del sistema operativo visualizzata dagli acquirenti.
**Sintassi della risposta **
Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la `ChangeSetId` e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò includeva la convalida delle informazioni per garantire che soddisfino le linee guida. Marketplace AWS Il processo di convalida può richiedere da pochi minuti a qualche ora.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API del catalogo utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
Per ulteriori informazioni sugli errori nei set di modifiche ai prodotti del venditore, consulta[Modifica lo stato e gli errori del set](work-with-seller-products.md#seller-product-change-set-errors).
Una volta completata la richiesta, la versione viene aggiunta e tutti gli abbonati esistenti riceveranno un messaggio e-mail che li informa della nuova versione. Per ulteriori informazioni sul processo di aggiunta di una nuova versione, consulta [ Aggiungere una nuova versione ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-adding-version) nella Guida * per il *Marketplace AWS venditore.
**Errori asincroni **
Gli errori seguenti 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).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_AMI\_NAME | Il prefisso (x) nel nome AMI non è valido. Fornisci un nuovo nome utilizzando il nome della tua azienda o del tuo marchio come prefisso. |
| PRODOTTO\_NON VALIDO | Usa un prodotto pubblico o limitato esistente. |
| TITOLO\_VERSIONE\_DUPLICATO | Il titolo della versione deve essere diverso da qualsiasi altro titolo di versione di questo prodotto. |
| TITOLO\_VERSIONE\_NON VALIDO | Rimuovi gli spazi prima del simbolo del marchio. |
| TITOLO\_VERSIONE\_NON VALIDO | Rimuovi i caratteri non supportati: [x, y, z] |
| INVALID\_VERSION\_TITLE | Rimuovi gli spazi dall'inizio del titolo della versione. |
| TITOLO\_VERSIONE\_NON VALIDO | Fornisci il titolo della versione con meno di [x] caratteri. |
| NOTE\_DI\_RELEASE NON VALIDE | Rimuovi gli spazi prima del simbolo del marchio. |
| NOTE\_DI\_RELEASE NON VALIDE | Rimuovi i caratteri non supportati: [x, y, z] |
| INVALID\_RELEASE\_NOTES | Rimuovi gli spazi all'inizio delle note di rilascio. |
| NOTE\_DI\_RELEASE NON VALIDE | Fornisci note di rilascio con meno di (x) caratteri. |
| ISTRUZIONI\_DI\_USO NON VALIDE | Rimuovi gli spazi prima del simbolo del marchio. |
| ISTRUZIONI\_DI\_USO NON VALIDE | Rimuovi caratteri non supportati: [x, y, z] |
| INVALID\_USAGE\_INSTRUCTIONS | Rimuovi gli spazi all'inizio delle note di rilascio. |
| ISTRUZIONI\_DI\_USO NON VALIDE | Fornisci istruzioni per l'uso con meno di (x) caratteri. |
| TIPO\_DI\_ISTANZA\_CONSIGLIATA NON DISPONIBILE | Fornisci un tipo di istanza esistente e disponibile. |
| TIPO\_ISTANZA\_CONSIGLIATA NON VALIDO | Fornisci un tipo di istanza valido. |
| GRUPPO\_DI\_SICUREZZA NON VALIDO | Le porte del gruppo di sicurezza devono essere comprese tra 1 e [max]. |
| GRUPPO\_DI\_SICUREZZA NON VALIDO | Fornisci un valore per gli intervalli IP CIDR. |
| GRUPPO\_DI\_SICUREZZA NON VALIDO | Fornisci una porta iniziale del gruppo di sicurezza che non sia maggiore della porta finale. |
| PROTOCOLLO\_DI\_SICUREZZA\_DI\_GRUPPO\_NON VALIDO | Il protocollo del gruppo di sicurezza deve essere 'tcp' o 'udp'. |
| CIDR\_IP NON VALIDO | Fornisci l'intervallo IP CIDR standard nel formato '0.0.0. 0/0'. |
| PORTA\_ENDPOINT\_ACCESS\_NON VALIDA | Fornisci una porta endpoint inferiore a [x]. |
| PORTA\_ENDPOINT\_ACCESS\_NON VALIDA | Fornisci una porta endpoint compresa tra 1 e [max]. |
| PORTA\_ENDPOINT\_ACCESS\_NON VALIDA | Fornisci la porta dell'endpoint. |
| PERCORSO\_DI\_ENDPOINT\_RELATIVE\_NON VALIDO | Rimuovi gli spazi nel percorso relativo. |
| PERCORSO\_DI\_ENDPOINT\_RELATIVE\_NON VALIDO | Rimuovi la '/' precedente dal percorso relativo. |
| SISTEMA\_OPERATIVA\_INCOMPATIBILE | Fornisci il nome e la versione del sistema operativo compatibili con i tipi di istanza: [x] |
| INCOMPATIBLE\_OPERATING\_SYSTEM\_NAME | Fornisci un nome con meno di (x) caratteri. |
| NOME\_SISTEMA\_OPERATIVO INCOMPATIBILE | Fornire il nome del sistema operativo supportato. |
| VERSIONE\_OPERATIVA\_INCOMPATIBILE DEL SISTEMA\_OPERATIVO | Fornisci una versione con meno di (x) caratteri. |
| PORTA\_DI SCANSIONE NON VALIDA | Fornire una porta di scansione compresa tra 1 e [max]. |
| AMI\_ID NON VALIDO | Fornisci un ID AMI valido. |
| CODICE\_AMI\_PRODOTTO ESISTENTE | Rimuovi il codice prodotto allegato all'immagine X. |
| INVALID\_AMI\_ARCHITECTURE | Fornisci una nuova AMI con architettura [x]. |
| TIPO\_AMI\_VIRTUALIZATION\_NON VALIDO | Fornisci una nuova AMI con tipo di virtualizzazione [x]. |
| TIPO\_AMI\_VIRTUALIZATION\_NON VALIDO | Fornisci il volume previsto [z] sull'immagine [x]. |
| AMI\_INCOMPATIBILE | Fornisci una nuova AMI poiché l'architettura [x] su [y] non è supportata dai seguenti tipi di istanza: [z] |
| INCOMPATIBLE\_AMI | Fornisci una nuova AMI poiché il tipo di virtualizzazione [x] su [y] non è supportato dai seguenti tipi di istanza: [z] |
| INCOMPATIBLE\_AMI | Abilita il supporto ENA per l'immagine x perché i seguenti tipi di istanza richiedono il supporto ENA: [y] |
| ASSET\_NOT\_FOUND | Controlla se [ami-id] esiste nella regione us-east-1 di [account-id] Account AWS e l' [ARN] fornito dispone delle autorizzazioni per condividere questo AMI. AccessARN Marketplace AWS |
| ASSET\_ACCESS\_EXCEPTION | Impossibile copiare AMI [x] nell'account. Marketplace AWS |
| ERRORE DI SCANSIONE | Correggi la vulnerabilità di sicurezza [y] sull'immagine [x]. |
| RISORSA NON TROVATA | Controlla se [afi-id] esiste nella regione us-east-1 di [account-id] Account AWS e l' [ARN] fornito dispone delle autorizzazioni per condividere questo AFIAccessARN. Marketplace AWS |
| ASSET\_ACCESS\_EXCEPTION | Impossibile accedere all'AFI. Controlla se AccessARN fornito da [ARN] dispone delle autorizzazioni per condividere questo AFI Marketplace AWS e il ruolo di accesso L'account è proprietario dell'AFI. |
| TIPO\_FPGA\_INSTANCE\_MANCANTE | Nessun tipo di istanza basato su FPGA trovato. Usa AddInstanceTypes change type per aggiungere un tipo di istanza basato su FPGA. |
Puoi anche creare un AMI-based prodotto utilizzando il Portale di gestione Marketplace AWS. Per ulteriori informazioni, consulta i prodotti [ AMI ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html) nella Guida per i *Marketplace AWS venditori*.
Per una guida dettagliata su come automatizzare l'aggiornamento AMI-based del prodotto, puoi anche fare riferimento al video, [ Automatizzare gli aggiornamenti delle offerte di prodotto Marketplace AWS con Catalog API ](https://www.youtube.com/watch?v=7KpUJ6Wcqrg) (5:08).
## Aggiorna le informazioni sulla versione
Puoi utilizzare l'API del catalogo per aggiornare i dettagli di una versione esistente del tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per ulteriori informazioni sull'aggiornamento delle informazioni sulla versione utilizzando il Portale di gestione Marketplace AWS, consulta [ Aggiornamento delle informazioni sulla versione ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-updating-version) nella Guida per il *Marketplace AWS venditore*.
Non puoi aggiornare l'AMI per la versione. Se devi aggiornare l'AMI, crea invece una nuova versione.
Per aggiungere una nuova versione, chiama l'operazione `StartChangeSet` API con il tipo di `UpdateDeliveryOptions` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateDeliveryOptions",
"Entity":
{
"Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
"Type": "AmiProduct@1.0"
},
"DetailsDocument":
{
"Version":
{
"ReleaseNotes": "*My new Release notes*"
},
"DeliveryOptions":
[
{
"Id": "example1-2222-cccc-2222-cccccccccccc",
"Details":
{
"AmiDeliveryOptionDetails":
{
"UsageInstructions": "Easy to use AMI"
}
}
},
{
"Id": "example1-2222-dddd-2222-dddddddddddd",
"Details":
{
"DeploymentTemplateDeliveryOptionDetails":
{work with ami
"DeliveryOptionTitle": "My updated delivery option title",
"UsageInstructions": "Updated usage instructions here."
}
}
}
]
}
}
]
}
```
Di seguito sono riportate informazioni sui campi di input forniti per aggiungere il tipo di `UpdateDeliveryOptions` modifica. Per ulteriori informazioni su questi campi, consulta [ Aggiornamento delle informazioni sulla versione ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-updating-version) nella Guida per il Marketplace AWS venditore.
+ **Entità ** (oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ **Identificatore ** (stringa) (obbligatorio): l'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **Tipo ** (stringa) (obbligatorio): si `Type` basa sul metodo di spedizione (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+ **DetailsDocument**(oggetto) (obbligatorio) — Dettagli della richiesta. Include tutte le informazioni sulla versione del AMI-based prodotto che desideri aggiornare. I campi inclusi sono tutti opzionali, ma è necessario includere almeno un campo per l'aggiornamento.
+ **Versione ** (oggetto): dettagli sulla versione del software.
+ **ReleaseNotes**(stringa) — Note per gli acquirenti per indicare loro le modifiche da una versione all'altra.
+ **DeliveryOptions**(matrice di oggetti) — Elenco degli oggetti delle opzioni di consegna. Includi solo le opzioni di consegna che desideri aggiornare.
+ Per l'opzione di * consegna * AMI (autonoma), specifica un oggetto con i seguenti dettagli. Includi solo i campi che desideri aggiornare. Tutti i campi sono opzionali se non diversamente specificato.
+ **Id ** (string) (obbligatorio): identificatore univoco per l'opzione di consegna (puoi ottenere l'identificatore univoco per l'opzione di consegna richiamando l'`DescribeEntity`azione sul prodotto che stai aggiornando).
+ **Dettagli ** (oggetto): contiene i dettagli di un'opzione di consegna AMI. Nota che questo oggetto di dettagli annidato * non ha * bisogno di un doppio escape.
+ **AmiDeliveryOptionDetails**(oggetto) — I dettagli di un'opzione di consegna AMI.
+ **UsageInstructions**(string) — Istruzioni per l'uso dell'AMI o un link a ulteriori informazioni sull'AMI.
+ **AccessEndpointUrl**(oggetto) — Utilizzato per creare un percorso per accedere all'AMI dopo il suo utilizzo.
+ **Porta ** (stringa): il numero di porta utilizzato per accedere al servizio in esecuzione sull'AMI.
+ **Protocollo ** (stringa): il protocollo (`http`o`https`) utilizzato per accedere al servizio in esecuzione sull'AMI.
+ **RelativePath**(stringa) — Il percorso dalla radice web per accedere al servizio in esecuzione sull'AMI (ad esempio{{/index.html}}).
+ **RecommendedInstanceType**(string) — Il tipo di istanza consigliato per eseguire il servizio con l'AMI ed è l'impostazione predefinita per le installazioni del servizio con 1 clic.
+ **SecurityGroups**(array di oggetti) — Un elenco di oggetti che rappresentano le regole di ingresso per i gruppi creati automaticamente per la versione:
+ **FromPort**(numero intero) — La porta di origine.
+ **IpProtocol**(stringa) — Il protocollo da utilizzare (`tcp`or`idp`).
+ **IpRanges**(matrice di stringhe) — Intervalli IP da consentire, in formato CIDR (nel formato xxx.xxx.xxx. * xxx/nn*, ad esempio,). {{192.0.2.0/24}}
+ **ToPort**(numero intero) — La porta di destinazione.
+ Per * AMI con opzione CloudFormation * di consegna, specifica un oggetto con i seguenti dettagli. Includi solo i campi che desideri aggiornare. Tutti i campi sono opzionali se non diversamente specificato.
+ **Id ** (string) (obbligatorio): identificatore univoco per l'opzione di consegna (puoi ottenere l'identificatore univoco per l'opzione di consegna richiamando l'`DescribeEntity`azione sul prodotto che stai aggiornando).
+ **Dettagli ** (oggetto): contiene i dettagli di un'opzione di consegna AMI. Nota che questo oggetto di dettagli annidato * non ha * bisogno di un doppio escape.
+ **DeploymentTemplateDeliveryOptionDetails**(oggetto) — Utilizzato per fornire i dettagli di ciascuna opzione di consegna CFT.
+ **DeliveryOptionTitle**(string) — Titolo per l'opzione di consegna.
+ **ShortDescription**(string) — Breve descrizione dell'opzione di consegna del CloudFormation modello.
+ **LongDescription**(string) — Descrizione dettagliata dell'opzione di consegna del CloudFormation modello.
+ **UsageInstructions**(string) — Istruzioni per l'uso dell'AMI o un link a ulteriori informazioni sull'AMI.
+ **RecommendedInstanceType**(string) — Il tipo di istanza consigliato per eseguire il servizio con l'AMI ed è quello predefinito per le installazioni del servizio con 1 clic. Per un elenco dei tipi di istanza, consulta la sezione Tipi di [ istanza ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) nella * Amazon Elastic Compute Cloud User Guide for Linux Instances. *
+ **ArchitectureDiagram**(string) — URL della posizione del diagramma architettonico in Amazon S3.
+ **Modello ** (stringa): URL della posizione del CloudFormation modello in Amazon S3.
+ **TemplateSources**(serie di oggetti)
+ **ParameterName**(stringa) — Nome del parametro nel CloudFormation modello a cui deve essere passata l'AMI in questa versione. Per ulteriori informazioni, consulta [ i dettagli sui requisiti per l'AMI](https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation.html#ami-requirements-sse).
+ **AmiSource**(oggetto)
+ **AmiId**(stringa) — ID dell'AMI di origine, situato nel luogo in Regione AWS cui viene chiamata l'API (attualmente deve essere sempre Stati Uniti orientali (Virginia settentrionale) perché è l'unica regione in cui è disponibile l'API del catalogo). Deve appartenere all'account del chiamante.
+ **AccessRoleArn**(stringa) — Ruolo IAM Amazon Resource Name (ARN) utilizzato Regione AWS per accedere all'AMI fornita. Per informazioni dettagliate sulla creazione e l'utilizzo di questo ARN, consulta [ Dare ad AWS Marketplace l'accesso alla tua AMI ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-marketplace-ami-access) nella *Marketplace AWS Seller Guide. *
+ **UserName**(string) — Nome utente di login per accedere al sistema operativo (OS) nell'AMI. In genere `ec2-user` per le AMI Linux o `Administrator` per Windows.
+ **OperatingSystemName**(stringa) — Nome del sistema operativo visualizzato agli acquirenti.
+ **OperatingSystemVersion**(string) — Stringa della versione del sistema operativo visualizzata dagli acquirenti.
**Sintassi della risposta **
Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la `ChangeSetId` e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò includeva la convalida delle informazioni per garantire che soddisfino le linee guida. Marketplace AWS Il processo di convalida può richiedere da pochi minuti a qualche ora.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API del catalogo utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
Per ulteriori informazioni sui set di modifiche, consulta [Utilizzo dei set di modifiche](catalog-apis.md#working-with-change-sets). Per ulteriori informazioni sugli errori nei set di modifiche ai prodotti del venditore, consulta[Modifica lo stato e gli errori del set](work-with-seller-products.md#seller-product-change-set-errors).
**Errori asincroni **
Gli errori seguenti sono specifici `UpdateDeliveryOptions` 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).
È possibile recuperare `UpdatePricingTerms` le azioni utilizzando l'`DescribeChangeSet`operazione dopo l'inizio dell'elaborazione del set di modifiche. Per ulteriori informazioni sui dettagli degli errori e sulla risoluzione dei problemi, consulta la [Modifica lo stato e gli errori del set](work-with-seller-products.md#seller-product-change-set-errors) sezione precedente di questa guida.
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_PRODUCT | Usa un prodotto pubblico o limitato esistente. |
| ID\_OPZIONE\_DI\_CONSEGNA MANCANTI | Fornisci almeno un ID dell'opzione di consegna. |
| ID\_OPZIONE\_DI\_CONSEGNA NON VALIDI | Fornisci gli ID delle opzioni di spedizione che possono essere trovati nel prodotto. ID non trovati: [x] |
| OPZIONI DI CONSEGNA NON VALIDE | Fornisci gli ID delle opzioni di spedizione che appartengono alla stessa versione. |
## Limita una versione
Puoi utilizzare l'API del catalogo per limitare una versione del tuo AMI-based prodotto. Ciò impedisce ai nuovi acquirenti di utilizzare quella versione, ma la mantiene disponibile per gli acquirenti esistenti. La limitazione di tutte le opzioni di spedizione di una versione limita la versione. La limitazione di una o più opzioni di consegna, ma non tutte, di una versione limita solo le opzioni di consegna di quella versione. Devi avere sempre a disposizione almeno una versione senza restrizioni di un prodotto, quindi non puoi limitare l'ultima versione disponibile al pubblico di un prodotto.
**Nota**
Per ulteriori informazioni sulla limitazione delle versioni AMI Marketplace AWS tramite il Portale di gestione Marketplace AWS, consulta [ Limitare una versione ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-restricting-version) nella Guida per il *Marketplace AWS venditore. *
Per limitare una versione, richiama l'operazione `StartChangeSet` API con il tipo di `RestrictDeliveryOptions` modifica, come mostrato nell'esempio seguente.
**Nota**
Tutti gli abbonati possono utilizzare la versione corrente indipendentemente dallo stato della restrizione. Marketplace AWS le linee guida richiedono che tu continui a offrire assistenza agli acquirenti esistenti per 90 giorni dopo la limitazione della versione. La tua AMI verrà contrassegnata come obsoleta dopo la limitazione della versione. Per ulteriori informazioni, consulta [ Deprecate an AMI ](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ami-deprecate.html) nella * Amazon Elastic Compute Cloud User Guide for Instances. Windows *
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "RestrictDeliveryOptions",
"Entity":
{
"Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
"Type": "AmiProduct@1.0"
},
"DetailsDocument":
{
"DeliveryOptionIds":
[
"{{example1-2222-cccc-2222-cccccccccccc}}"
]
}
}
]
}
```
Di seguito sono riportate informazioni sui campi di input forniti per aggiungere il tipo di modifica: `RestrictDeliveryOptions`
+ **Entità ** (oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ **Identificatore ** (stringa) (obbligatorio): l'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ **Tipo ** (stringa) (obbligatorio): si `Type` basa sul metodo di spedizione (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+ **DetailsDocument**(oggetto) (obbligatorio) — Dettagli della richiesta. Include gli ID delle versioni del AMI-based prodotto che desideri limitare.
+ **DeliveryOptionIds**(matrice di oggetti): elenco di `DeliveryOption` ID per le versioni che desideri limitare. È possibile ottenere l'identificatore univoco `DeliveryOption` richiamando l'`DescribeEntity`azione sulla versione che si sta limitando.
**Sintassi della risposta **
Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la `ChangeSetId` e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò includeva la convalida delle informazioni per garantire che soddisfino le linee guida. Marketplace AWS Il processo di convalida può richiedere da pochi minuti a qualche ora.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API del catalogo utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Errori asincroni **
Gli errori seguenti sono specifici `RestrictDeliveryOptions` 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).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_PRODUCT | Usa un prodotto pubblico esistente. |
| ID\_OPZIONI\_DI\_CONSEGNA MANCANTI | Fornisci almeno un ID dell'opzione di consegna. |
| ID\_OPZIONE\_DI\_CONSEGNA NON VALIDI | Fornisci gli ID delle opzioni di spedizione che possono essere trovati nel prodotto. ID non trovati: [x] |
| INVALID\_DELIVERY\_OPTION | Fornisci gli ID delle opzioni di consegna che sono in uno stato pubblico. ID non in stato pubblico: [x] |
| ALL\_DELIVERY\_OPTIONS\_RESTRICTED | Fornisci un numero inferiore di opzioni di consegna da limitare poiché almeno una deve rimanere in stato pubblico. |
## Aggiornamento futuro Regione AWS supporto
Puoi utilizzare l'API del catalogo per modificare le preferenze di Regione AWS supporto future per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per ulteriori informazioni sulla modifica del supporto per le regioni future utilizzando il Portale di gestione Marketplace AWS, consulta [ Update support for future AWS Regions ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-updating-future-region-support) nella *Marketplace AWS Seller Guide*.
**Nota**
Il tipo di `UpdateFutureRegionSupport` modifica è disponibile solo su`AmiProduct@1.0`.
Per modificare le preferenze di Regione AWS supporto future, richiama l'operazione `StartChangeSet` API con il tipo di `UpdateFutureRegionSupport` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "UpdateFutureRegionSupport",
"Entity":
{
"Identifier": "{{prod-example12345}}",
"Type": "AmiProduct@1.0"
},
"DetailsDocument":
{
"FutureRegionSupport":
{
"SupportedRegions":
[
"All"
]
}
}
}
]
}
```
Fornisci informazioni per i campi per aggiungere il tipo di `UpdateFutureRegionSupport` modifica:
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(string) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (obbligatorio) — `Type` Si basa sul metodo di spedizione (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+ `DetailsDocument`(oggetto) (obbligatorio) — I dettagli necessari per eseguire il ChangeSet.
+ `FutureRegionSupport`— Oggetto
+ `SupportedRegions`— Single-element matrice di stringhe
Valori supportati dagli elementi: uno tra [`"All"`,`"US"`,`"None"`]
**Sintassi della risposta **
Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la `ChangeSetId` e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò includeva la convalida delle informazioni per garantire che soddisfino le linee guida. Marketplace AWS Il processo di convalida può richiedere da pochi minuti a qualche ora.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API del catalogo utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Errori asincroni **
Gli errori seguenti sono specifici `UpdateFutureRegionSupport` 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).
| Codice di errore | Messaggio di errore |
| --- | --- |
| TOO\_MANY\_REGIONS | Attualmente, è supportato solo 1 valore per FutureRegionSupport: Tutti, Stati Uniti o Nessuno |
| INVALID\_REGIONS | Le regioni richieste [a, b, c] non sono valide o non sono disponibili. Solo i valori supportati sono [x, y, z]. |
| INPUT\_NON VALIDO | SupportedRegions non può essere vuoto. |
## Aggiungi un supporto Regione AWS
Puoi utilizzare l'API del catalogo per aggiungere un nuovo supporto Regioni AWS per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per ulteriori informazioni sull'aggiunta di nuove regioni supportate utilizzando il Portale di gestione Marketplace AWS, consulta [ Aggiungere una regione AWS ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-adding-regions) nella Guida per i *Marketplace AWS venditori*.
**Nota**
Il tipo di `AddRegions` modifica è disponibile solo su`AmiProduct@1.0`.
Per aggiungere nuove regioni supportate, richiamate l'operazione `StartChangeSet` API con il tipo di `AddRegions` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "AddRegions",
"DetailsDocument": {
"Regions": [
"{{us-east-1}}",
"{{ap-northeast-2}}"
]
},
"Entity": {
"Identifier": "{{prod-123456@1}}",
"Type": "AmiProduct@1.0"
}
}
]
}
```
Fornisci informazioni per i campi per aggiungere il tipo di `AddRegions` modifica.
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(string) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (obbligatorio) — `Type` Si basa sul metodo di spedizione (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+
**Example**
+ `Regions`: array di stringhe
Valori supportati dagli elementi: stringhe di Regione AWS codice valide.
Ad esempio, [`"us-east- 1"`].
**Sintassi della risposta **
Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la `ChangeSetId` e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò includeva la convalida delle informazioni per garantire che soddisfino le linee guida. Marketplace AWS Il processo di convalida può richiedere da pochi minuti a qualche ora.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API del catalogo utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
+ Se lo stato di esecuzione del set di modifiche è`SUCCEEDED`: viene generata una nuova entità `Identifier` (o`EntityId`). È possibile utilizzare l'operazione [`DescribeEntity`](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeEntity.html) API sull'entità del prodotto per verificare il risultato.
+ Se lo stato di esecuzione del set di modifiche è`CLIENT_ERROR`: La `DescribeChangeSet` risposta fornisce i dettagli dell'errore e le azioni corrispondenti da intraprendere per correggerlo.
**Errori asincroni **
Gli errori seguenti sono specifici `AddRegions` 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).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_REGIONS | Le regioni richieste [a, b, c] non sono valide o non sono disponibili. Solo i valori supportati sono [x, y, z]. |
| INPUT\_NON VALIDO | Le regioni non possono essere vuote. |
## Limita un Regione AWS
Puoi utilizzare l'API del catalogo per limitare il supporto precedentemente supportato Regioni AWS per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per ulteriori informazioni sulla limitazione delle regioni precedentemente supportate utilizzando il Portale di gestione Marketplace AWS, consulta [ Restrict an AWS Region ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-restricting-regions) nella *Marketplace AWS Seller Guide*.
**Nota**
Il tipo di `RestrictRegions` modifica è disponibile solo su. `AmiProduct@1.0`
Per limitare le regioni precedentemente supportate, richiamate l'operazione `StartChangeSet` API con il tipo di `RestrictRegions` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "RestrictRegions",
"DetailsDocument": {
"Regions": [
"{{us-east-1}}",
"{{ap-northeast-2}}"
]
},
"Entity": {
"Identifier": "{{prod-123456@1}}",
"Type": "AmiProduct@1.0"
}
}
]
}
```
Fornisci informazioni per i campi per aggiungere il tipo di `AddRegions` modifica.
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(string) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (obbligatorio) — `Type` Si basa sul metodo di spedizione (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+ **DetailsDocument**(oggetto) (obbligatorio) — I dettagli necessari per eseguire il ChangeSet.
+ `Regions`— Matrice di stringhe
Valori supportati dagli elementi: stringhe di Regione AWS codice valide, ad esempio. `"us-east-1"`
**Sintassi della risposta **
Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la `ChangeSetId` e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò includeva la convalida delle informazioni per garantire che soddisfino le Marketplace AWS linee guida. Il processo di convalida può richiedere da pochi minuti a qualche ora.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API del catalogo utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
+ Se lo stato di esecuzione del set di modifiche è`SUCCEEDED`: viene generata una nuova entità `Identifier` (o`EntityId`). È possibile utilizzare `DescribeEntity` l'entità del prodotto per verificare il risultato. Per ulteriori informazioni, consulta [`DescribeEntity`](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeEntity.html).
+ Se lo stato di esecuzione del set di modifiche è`CLIENT_ERROR`: La `DescribeChangeSet` risposta fornisce i dettagli dell'errore e le azioni corrispondenti da intraprendere per correggerlo.
**Errori asincroni **
Gli errori seguenti sono specifici `AddRegions` 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).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_REGIONS | Le regioni richieste [a, b, c] non sono valide o non sono disponibili. Solo i valori supportati sono [x, y, z]. |
| INSERIMENTO\_NON VALIDO | Le regioni non possono essere vuote. |
## Aggiungere un nuovo tipo di istanza
Puoi utilizzare l'API Catalog per aggiungere nuovi tipi di istanza per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per ulteriori informazioni sull'aggiunta di tipi di istanza utilizzando il Portale di gestione Marketplace AWS, consulta [ Aggiungere un'istanza ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-adding-instance-types) nella Guida per il *Marketplace AWS venditore*.
`AddInstanceTypes`aggiungerà nuovi tipi di istanza ai prodotti esistenti e ai prodotti appena creati durante la creazione di un prodotto. Il tipo di modifica aggiornerà tutte le versioni nel documento di prodotto con un nuovo tipo di istanza.
**Nota**
Il tipo di `AddInstanceTypes` modifica è disponibile solo su`AmiProduct@1.0`.
Quando si aggiunge un tipo di istanza con restrizioni, il tipo di istanza può essere rimosso dall'elenco con restrizioni e aggiunto all'elenco dei tipi di istanza disponibili. Ciò offre ai venditori un maggiore controllo sulla modifica delle restrizioni relative ai prodotti. L'elenco dei tipi di istanza è intercambiabile e non costituisce uno stato soggetto a restrizioni permanenti per un prodotto.
Per i prodotti a consumo interno, i venditori devono indicare tipi di modifica separati `AddDimensions` e aggiornare i prezzi per `UpdatePricingTerms` il tipo di istanza.
Per aggiungere nuovi tipi di istanza, richiama l'operazione `StartChangeSet` API con il tipo di `RestrictRegions` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
Di seguito viene mostrato solo il tipo di `AddInstanceTypes` modifica. Sebbene i venditori di AMI con conteggio interno siano tenuti a chiamare `AddInstanceTypes` e `UpdatePricingTerms` modificare il tipo di AMI.
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "AddInstanceTypes",
"Entity":
{
"Identifier": "{{prod-example12345}}",
"Type": "AmiProduct@1.0"
},
"DetailsDocument":
{
"InstanceTypes":
[
"m1.medium"
]
}
}
]
}
```
Fornisci informazioni per i campi per aggiungere il tipo di `AddInstanceTypes` modifica:
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(string) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (obbligatorio) — `Type` Si basa sul metodo di spedizione (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+ **DetailsDocument**(oggetto) (obbligatorio) — I dettagli necessari per eseguire il`ChangeSet`, in questo caso`InstanceTypes`.
+ `InstanceTypes`(matrice di stringhe) (obbligatorio) — Elenco di elementi `InstanceTypes` da aggiungere al prodotto. Queste istanze verranno aggiunte a quelle esistenti. `InstanceTypes`
**Sintassi della risposta **
Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la `ChangeSetId` e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò includeva la convalida delle informazioni per garantire che soddisfino le linee guida. Marketplace AWS Il processo di convalida può richiedere da pochi minuti a qualche ora.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API del catalogo utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Convalide sincrone **
Le seguenti convalide dello schema sono specifiche per `AddInstanceTypes` le azioni in. AWS Marketplace Catalog API Queste convalide vengono eseguite quando si chiama. `StartChangeSet` Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.
| Campo di immissione | Regola di convalida | HTTP |
| --- | --- | --- |
| InstanceTypes | Richiesto | 422 |
| InstanceTypes | Non deve essere vuota | 422 |
| InstanceTypes | Le iscrizioni devono contenere da 1 a 24 caratteri. Deve corrispondere a ^ [A-Za-z0-9\_.-] \+$ | 422 |
| InstanceTypes | Le iscrizioni devono essere uniche | 422 |
| InstanceTypes | Non devono essere più di 1500 iscrizioni | 422 |
| Una proprietà sconosciuta | Non sono consentite proprietà aggiuntive | 422 |
**Errori asincroni **
Gli errori seguenti sono specifici `AddInstanceTypes` 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).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_INSTANCE\_TYPES | I seguenti tipi di istanza non sono validi: [x] |
| INVALID\_INSTANCE\_VIRTUALIZATION | La virtualizzazione del prodotto è [x]. Non è supportato dai seguenti tipi di istanza: [x] |
| INVALID\_AMI\_ARCHITECTURE | L'architettura della CPU del prodotto è «%s».» \+ «Non è supportato dai seguenti tipi di istanza: [x] |
| SISTEMA\_OPERATIVA INCOMPATIBILE | I tipi di istanza sono incompatibili con il sistema operativo definito nel prodotto. Fornisci tipi di istanza compatibili con il sistema operativo definito nel prodotto. |
| TIPO\_PRODOTTO\_NON VALIDO | Usa un singolo prodotto AMI esistente. |
| INVALID\_ENA\_SETTING | Il prodotto non supporta ENA. Il supporto ENA è richiesto dai seguenti tipi di istanza: [x] |
| INVALID\_DIMENSIONS | Nessuna dimensione misurata internamente trovata per i tipi di istanza: [x] |
| MISSING\_DIMENSIONS | Nessuna dimensione trovata per il prodotto. AddDimensions è richiesto prima AddInstanceTypes. |
| AGGIORNAMENTO\_PREZZO\_OBBLIGATORIO | UpdatePricingTerms il tipo di modifica è necessario quando sul prodotto sono disponibili dimensioni misurate internamente. |
## Limita un tipo di istanza
Puoi utilizzare l'API del catalogo per limitare o limitare i tipi di istanze disponibili per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per ulteriori informazioni su come limitare o limitare i tipi di istanze disponibili utilizzando il Portale di gestione Marketplace AWS, consulta [ Limitare un'istanza ](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-restricting-instance-types) nella Guida * per il *Marketplace AWS venditore.
Gli abbonati esistenti non saranno interessati da questa modifica e potranno utilizzare i tipi di istanze con restrizioni. Tuttavia, nessun nuovo acquirente sarà in grado di utilizzare tipi di istanze con restrizioni. Per interrompere gli abbonamenti ai tipi di istanze correnti (una volta che i tipi di istanze saranno limitati), devi contattare il team operativo del Marketplace AWS venditore.
`RestrictInstanctTypes`limita i tipi di istanze a tutte le versioni presenti nel documento del prodotto. Nel tipo di `AddInstanceTypes` modifica, stai aggiornando tutte le versioni del prodotto. Non sarai in grado di limitare i tipi di istanze consigliati. Il tipo di istanza consigliato è a livello di versione, quindi è possibile che il venditore non sia in grado di limitare più tipi di istanza.
Per un prodotto a consumo interno, è necessario chiamare tipi di modifica diversi al momento della chiamata. `RestrictDimensions` Ciò impedisce la creazione di nuove offerte per i tipi di istanza soggetti a restrizioni.
**Nota**
Il tipo di `RestrictInstanceTypes` modifica è disponibile solo su`AmiProduct@1.0`.
Per limitare o limitare i tipi di istanze disponibili per il AMI-based prodotto, richiama l'operazione `StartChangeSet` API con il tipo di `RestrictInstanceTypes` modifica, come mostrato nell'esempio seguente.
**Sintassi della richiesta**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "RestrictInstanceTypes",
"Entity":
{
"Identifier": "{{prod-example12345}}",
"Type": "AmiProduct@1.0"
},
"DetailsDocument":
{
"InstanceTypes":
[
"m1.medium"
]
}
}
]
}
```
Fornisci informazioni per i campi per aggiungere il tipo di `RestrictInstanceTypes` modifica.
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(string) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(string) (obbligatorio) — `Type` Si basa sul metodo di spedizione (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+ **DetailsDocument**(oggetto) (obbligatorio) — I dettagli necessari per eseguire il`ChangeSet`, in questo caso`InstanceTypes`.
+ `InstanceTypes`(array di stringhe) (obbligatorio) — Elenco di stringhe `InstanceTypes` da limitare al prodotto. Queste istanze vengono aggiunte a quella corrente (o, se non esistono tipi di istanza esistenti, verranno aggiunte) a restricted. `InstanceTypes`
**Sintassi della risposta **
Viene creato un set di modifiche per la tua richiesta. La risposta a questa richiesta fornisce la `ChangeSetId` e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò includeva la convalida delle informazioni per garantire che soddisfino le linee guida. Marketplace AWS Il processo di convalida può richiedere da pochi minuti a qualche ora.
Puoi controllare lo stato della richiesta tramite o direttamente tramite Portale di gestione Marketplace AWS l'API del catalogo utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Convalide sincrone **
Le seguenti convalide dello schema sono specifiche per `RestrictInstanceTypes` le azioni in. AWS Marketplace Catalog API Queste convalide vengono eseguite quando si chiama. `StartChangeSet` Se la richiesta non soddisfa i seguenti requisiti, avrà esito negativo con una risposta HTTP.
| Campo di immissione | Regola di convalida | HTTP |
| --- | --- | --- |
| InstanceTypes | Richiesto | 422 |
| InstanceTypes | Non deve essere vuota | 422 |
| InstanceTypes | Le iscrizioni devono contenere da 1 a 24 caratteri. Deve corrispondere a ^ [A-Za-z0-9\_.-] \+$ | 422 |
| InstanceTypes | Le iscrizioni devono essere uniche | 422 |
| InstanceTypes | Non devono essere più di 1500 iscrizioni | 422 |
| Una proprietà sconosciuta | Non sono consentite proprietà aggiuntive | 422 |
**Errori asincroni **
Gli errori seguenti sono specifici `RestrictInstanceTypes` 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).
| Codice di errore | Messaggio di errore |
| --- | --- |
| INVALID\_ INSTANCE\_TYPES | I seguenti tipi di istanza non sono validi: [x] |
| INVALID\_ PRODUCT\_TYPE | Usa un singolo prodotto AMI esistente. |
| TIPO\_DI\_ISTANZA DUPLICATA | Fornisci tipi di istanza senza duplicati. |
| TIPO\_ISTANZA NON DISPONIBILE | Fornisci un tipo di istanza disponibile. |
| TIPO\_DI\_ISTANZA\_CONSIGLIATA | I seguenti tipi di istanza non possono essere limitati. Il tipo di istanza consigliato deve essere modificato con uno diverso prima di essere limitato. Id delle opzioni di consegna [X] Tipo di istanza [X] |
| DIMENSIONI\_NOT\_RESTRICTED | Limita le dimensioni prima di limitare i tipi di istanze con misurazione interna: [x] |
| REGION\_NO\_INSTANCES | I tipi di istanze con restrizioni causerebbero il fallimento del lancio del prodotto nella regione: X. Valuta la possibilità di limitare un numero inferiore di istanze. |
| RESTRIZIONE\_INCOMPATIBILE | I tipi di istanza con restrizioni causerebbero un prodotto senza tipi di istanza basati su FPGA per le AFI. Il prodotto deve supportare almeno un tipo di istanza basato su FPGA. |