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 AMI-based i prodotti
Puoi utilizzarlo AWS Marketplace Catalog API per automatizzare le attività relative all'utilizzo di 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 Catalog 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)
+ [Aggiorna future Regione AWS supporto](#update-future-region-support)
+ [Aggiungi un file supportato Regione AWS](#add-regions)
+ [Limita un Regione AWS](#restrict-regions)
+ [Aggiungi un nuovo tipo di istanza](#add-instance-types)
+ [Limita un tipo di istanza](#restrict-instance-types)
## Aggiungi una nuova versione
Puoi utilizzare l'API Catalog per aggiungere una nuova versione a un AMI-based prodotto esistente in Marketplace AWS. Per maggiori informazioni sull'aggiunta di nuove versioni AMI al tuo prodotto utilizzando la 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 al Marketplace AWS venditore*.
Quando crei 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 consentire ad AWS Marketplace di accedere all'AMI creando un ruolo AWS Identity and Access Management (IAM) con le autorizzazioni per eseguire azioni sull'AMI. *Per ulteriori informazioni sulle autorizzazioni richieste, consulta [Concedere ad AWS Marktplace l'accesso alla tua AMI nella Guida](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-marketplace-ami-access.html) al Marketplace AWS venditore.*
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 consegna 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 con il tipo di `AddDeliveryOptions` modifica. Tutti i campi sono obbligatori se non diversamente specificato. Per maggiori 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 al Marketplace AWS venditore.
+ **DeliveryOptions**(matrice di oggetti): un elenco di oggetti delle opzioni di consegna, inclusi i dettagli di ciascuno. È necessario includerne almeno uno.
+ Per l'opzione di consegna *AMI (standalone)*, specificare un oggetto con i seguenti dettagli. È possibile disporre di 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 necessita di 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**(stringa) — ID per l'AMI di origine, che si trova 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 Catalog. Deve appartenere all'account del chiamante.
+ **AccessRoleArn**(stringa) — Ruolo IAM Amazon Resource Name (ARN) utilizzato da Marketplace AWS per accedere all'AMI fornito. Per informazioni dettagliate sulla creazione e l'utilizzo di questo ARN, consulta [Concedere 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**(stringa) — Nome utente di accesso 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. Utilizzato per scansionare l'AMI fornito alla ricerca di vulnerabilità di sicurezza. Il valore predefinito è 22.
+ **OperatingSystemName**(stringa): nome del sistema operativo mostrato agli acquirenti.
+ **OperatingSystemVersion**(stringa) — Stringa della versione del sistema operativo mostrata agli acquirenti.
+ **AfiIds**(array di stringhe) (opzionale): ID Amazon FPGA Image (AFI) per abilitare il supporto FPGA per questa versione. Se fornito, consente al prodotto di funzionare su tipi di istanze F2. FPGA-enabled Puoi 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 [Concedere 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 Marketplace AWS Seller Guide.*
+ **UsageInstructions**(stringa) — Istruzioni per l'uso dell'AMI o un collegamento a ulteriori informazioni sull'AMI.
+ **AccessEndpointUrl**(oggetto) (opzionale) — Utilizzato per creare un percorso per accedere all'AMI dopo l'utilizzo.
+ **Port** (string) — 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**(stringa) — Il tipo di istanza consigliato per eseguire il servizio con l'AMI ed è l'impostazione predefinita per le installazioni con 1 clic del servizio. Per un elenco dei tipi di istanze, consulta [Tipi di istanza](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-types.html) nella *Guida per l'utente di Amazon Elastic Compute Cloud per istanze Linux*.
+ **SecurityGroups**(matrice di oggetti): un elenco di oggetti che rappresentano le regole di ingresso per i gruppi creati automaticamente per la versione.
+ **IpProtocol**(stringa) — Il protocollo da utilizzare (tcp o udp).
+ **FromPort**(integer) — La porta di origine.
+ **ToPort**(integer) — 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, specificare un oggetto con i seguenti dettagli. È possibile avere fino a tre opzioni di consegna di questo tipo.
+ **DeliveryOptionTitle**(stringa) — Titolo dell'opzione di consegna.
+ **Dettagli** (oggetto): contiene i dettagli di un'opzione di consegna AMI. Si noti che non è necessario che questo oggetto di dettagli annidato sia sottoposto a doppio escape.
+ **DeploymentTemplateDeliveryOptionDetails**(oggetto): consente di fornire i dettagli di ciascuna opzione di consegna CFT.
+ **ShortDescription**(stringa) — Breve descrizione dell'opzione di consegna del CloudFormation modello.
+ **LongDescription**(stringa) — Descrizione dettagliata dell'opzione di consegna del CloudFormation modello.
+ **UsageInstructions**(stringa) — Istruzioni per l'uso dell'AMI o un collegamento a ulteriori informazioni sull'AMI.
+ **RecommendedInstanceType**(stringa) — Il tipo di istanza consigliato per eseguire il servizio con l'AMI ed è l'impostazione predefinita per le installazioni con 1 clic del servizio. Per un elenco dei tipi di istanze, consulta [Tipi di istanza](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-types.html) nella *Guida per l'utente di Amazon Elastic Compute Cloud per istanze Linux*.
+ **ArchitectureDiagram**(stringa) — URL della posizione del diagramma architettonico in Amazon S3.
+ **Modello** (stringa): URL della posizione del CloudFormation modello in Amazon S3.
+ **TemplateSources**(matrice di oggetti)
+ **ParameterName**(stringa) — Nome del parametro nel CloudFormation modello a cui deve essere passato l'AMI in questa versione. Per ulteriori informazioni, consulta [Requisiti per i dettagli sulle AMI](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html#ami-requirements-sse).
+ **AmiSource**(oggetto)
+ **AmiId**(stringa) — ID per l'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 Catalog). Deve appartenere all'account del chiamante.
+ **AccessRoleArn**(stringa) — Ruolo IAM Amazon Resource Name (ARN) utilizzato da Regione AWS per accedere all'AMI fornito. Per informazioni dettagliate sulla creazione e l'utilizzo di questo ARN, consulta [Concedere 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**(stringa) — Nome utente di accesso per accedere al sistema operativo (OS) nell'AMI. In genere `ec2-user` per AMI Linux o `Administrator` per Windows.
+ **OperatingSystemName**(stringa): nome del sistema operativo mostrato agli acquirenti.
+ **OperatingSystemVersion**(stringa) — Stringa della versione del sistema operativo mostrata agli acquirenti.
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`ChangeSetId`e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò ha incluso 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 Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
Per maggiori 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, viene aggiunta la versione e tutti gli abbonati esistenti riceveranno un messaggio e-mail contenente informazioni sulla nuova versione. Per maggiori informazioni sulla procedura 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 al Marketplace AWS venditore*.
**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).
| Codice di errore | Messaggio di errore |
| --- | --- |
| NOME\_AMI NON VALIDO | Il prefisso (x) nel nome AMI non è valido. Fornisci un nuovo nome utilizzando il nome della tua azienda o del marchio come prefisso. |
| PRODOTTO\_NON VALIDO | Usa un prodotto pubblico o limitato esistente. |
| 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] |
| INVALID\_RELEASE\_NOTES | 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 | Rimuovi gli spazi dall'inizio delle note di rilascio. |
| INVALID\_USAGE\_INSTRUCTIONS | Fornisci istruzioni d'uso con meno di (x) caratteri. |
| TIPO\_ISTANZA\_CONSIGLIATA\_NOT\_AVAILABLE | Fornite un tipo di istanza esistente e disponibile. |
| INVALID\_RECOMMENDED\_INSTANCE\_TYPE | Fornite un tipo di istanza valido. |
| INVALID\_SECURITY\_GROUP | Le porte del gruppo di sicurezza devono essere comprese tra 1 e [max]. |
| INVALID\_SECURITY\_GROUP | Fornisci un valore per gli intervalli IP CIDR. |
| INVALID\_SECURITY\_GROUP | Fornisci una porta iniziale del gruppo di sicurezza che non sia maggiore della porta finale. |
| INVALID\_SECURITY\_GROUP\_PROTOCOL | Il protocollo del gruppo di sicurezza deve essere 'tcp' o 'udp'. |
| INVALID\_CIDR\_IP | Fornisci un intervallo IP CIDR standard nel formato '0.0.0. 0/0'. |
| PORTA\_ACCESS\_ENDPOINT\_NON VALIDA | Fornisci una porta endpoint inferiore a [x]. |
| INVALID\_ACCESS\_ENDPOINT\_PORT | Fornisci una porta endpoint compresa tra 1 e [max]. |
| INVALID\_ACCESS\_ENDPOINT\_PORT | Fornire la porta dell'endpoint. |
| INVALID\_ACCESS\_ENDPOINT\_RELATIVE\_PATH | Rimuovi gli spazi nel percorso relativo. |
| INVALID\_ACCESS\_ENDPOINT\_RELATIVE\_PATH | Rimuovi il '/' precedente dal percorso relativo. |
| SISTEMA\_OPERATING\_INCOMPATIBILE | Fornisci il nome e la versione del sistema operativo compatibili con i tipi di istanza: [x] |
| NOME\_SISTEMA\_OPERATING\_INCOMPATIBILE | Fornisci un nome con meno di (x) caratteri. |
| NOME\_SISTEMA\_OPERATING\_INCOMPATIBILE | Fornire il nome del sistema operativo supportato. |
| VERSIONE\_SISTEMA\_OPERATING\_OPERATIVO INCOMPATIBILE | Fornisci una versione con meno di (x) caratteri. |
| INVALID\_SCANNING\_PORT | Fornisce una porta di scansione compresa tra 1 e [max]. |
| INVALID\_AMI\_ID | Fornisci un ID AMI valido. |
| EXISTING\_AMI\_PRODUCT\_CODE | 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 [z] previsto sull'immagine [x]. |
| INCOMPATIBLE\_AMI | Fornire una nuova AMI come architettura [x] su [y] non è supportato dai seguenti tipi di istanze: [z] |
| INCOMPATIBLE\_AMI | Fornire una nuova AMI come tipo di virtualizzazione [x] su [y] non è supportato dai seguenti tipi di istanze: [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] AccessARN fornito dispone delle autorizzazioni per condividere questo AMI. Marketplace AWS |
| ASSET\_ACCESS\_EXCEPTION | Impossibile copiare AMI [x] nell' Marketplace AWS account. |
| SCAN\_ERROR | Risolve la vulnerabilità di sicurezza [y] su Image [x]. |
| ASSET\_NOT\_FOUND | Controlla se [afi-id] esiste nella regione us-east-1 di [account-id] Account AWS e l' [ARN] AccessARN fornito dispone delle autorizzazioni per condividere questa AFI. Marketplace AWS |
| ASSET\_ACCESS\_EXCEPTION | Impossibile accedere all'AFI. Verifica se accessARN fornito da [ARN] dispone delle autorizzazioni per condividere questa AFI Marketplace AWS e il ruolo di accesso L'account è il proprietario dell'AFI. |
| MISSING\_FPGA\_INSTANCE\_TYPE | Nessun tipo di istanza basato su FPGA trovato. Usa AddInstanceTypes change type per aggiungere un tipo di istanza basata su FPGA. |
Puoi anche creare un AMI-based prodotto utilizzando. Portale di gestione Marketplace AWS Per maggiori informazioni, consulta [i prodotti AMI](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html) nella *Guida Marketplace AWS del venditore*.
Per una procedura dettagliata che mostra come automatizzare l'aggiornamento AMI-based del prodotto, puoi anche fare riferimento al video, [Automatizzare gli aggiornamenti delle tue offerte di prodotti Marketplace AWS con l'API del catalogo](https://www.youtube.com/watch?v=7KpUJ6Wcqrg) (5:08).
## Aggiorna le informazioni sulla versione
Puoi utilizzare l'API Catalog per aggiornare i dettagli di una versione esistente del tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per maggiori 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 al Marketplace AWS venditore*.
Non è possibile aggiornare l'AMI per la versione. Se devi aggiornare l'AMI, crea invece una nuova versione.
Per aggiungere una nuova versione, chiamate l'operazione `StartChangeSet` API con il tipo di `UpdateDeliveryOptions` modifica, come illustrato 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 maggiori informazioni su questi campi, consulta la sezione [Aggiornamento delle informazioni sulla versione](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-updating-version) nella Guida del 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 facoltativi, ma è necessario includere almeno un campo da aggiornare.
+ **Versione** (oggetto): dettagli sulla versione del software.
+ **ReleaseNotes**(stringa) — Note per gli acquirenti per informare gli acquirenti sulle 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 (standalone)*, specificare 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. Si noti che *non* è necessario che questo oggetto di dettagli annidato sia sottoposto a doppio escape.
+ **AmiDeliveryOptionDetails**(oggetto) — I dettagli di un'opzione di consegna AMI.
+ **UsageInstructions**(stringa) — Istruzioni per l'uso dell'AMI o un collegamento a ulteriori informazioni sull'AMI.
+ **AccessEndpointUrl**(oggetto) — Utilizzato per creare un percorso per accedere all'AMI dopo l'utilizzo.
+ **Port** (string) — 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**(stringa) — Il tipo di istanza consigliato per eseguire il servizio con l'AMI ed è l'impostazione predefinita per le installazioni con 1 clic del servizio.
+ **SecurityGroups**(matrice di oggetti) — Un elenco di oggetti che rappresentano le regole di ingresso per i gruppi creati automaticamente per la versione:
+ **FromPort**(intero) — La porta di origine.
+ **IpProtocol**(stringa) — Il protocollo da utilizzare (`tcp`o`idp`).
+ **IpRanges***(array di stringhe) — Intervalli IP da consentire, in formato CIDR (nel formato xxx.xxx.xxx). xxx/nn*, ad esempio,). {{192.0.2.0/24}}
+ **ToPort**(integer) — La porta di destinazione.
+ Per *AMI con* opzione CloudFormation di consegna, specificare 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. Si noti che *non* è necessario che questo oggetto di dettagli annidato sia sottoposto a doppio escape.
+ **DeploymentTemplateDeliveryOptionDetails**(oggetto): consente di fornire i dettagli di ciascuna opzione di consegna CFT.
+ **DeliveryOptionTitle**(stringa) — Titolo dell'opzione di consegna.
+ **ShortDescription**(stringa) — Breve descrizione dell'opzione di consegna del CloudFormation modello.
+ **LongDescription**(stringa) — Descrizione dettagliata dell'opzione di consegna del CloudFormation modello.
+ **UsageInstructions**(stringa) — Istruzioni per l'uso dell'AMI o un collegamento a ulteriori informazioni sull'AMI.
+ **RecommendedInstanceType**(stringa) — Il tipo di istanza consigliato per eseguire il servizio con l'AMI ed è l'impostazione predefinita per le installazioni con 1 clic del servizio. Per un elenco dei tipi di istanze, consulta [Tipi di istanza](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-types.html) nella *Guida per l'utente di Amazon Elastic Compute Cloud per istanze Linux*.
+ **ArchitectureDiagram**(stringa) — URL della posizione del diagramma architettonico in Amazon S3.
+ **Modello** (stringa): URL della posizione del CloudFormation modello in Amazon S3.
+ **TemplateSources**(matrice di oggetti)
+ **ParameterName**(stringa) — Nome del parametro nel CloudFormation modello a cui deve essere passato l'AMI in questa versione. Per ulteriori informazioni, consulta [Requisiti per i dettagli sulle AMI](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html#ami-requirements-sse).
+ **AmiSource**(oggetto)
+ **AmiId**(stringa) — ID per l'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 Catalog). Deve appartenere all'account del chiamante.
+ **AccessRoleArn**(stringa) — Ruolo IAM Amazon Resource Name (ARN) utilizzato da Regione AWS per accedere all'AMI fornito. Per informazioni dettagliate sulla creazione e l'utilizzo di questo ARN, consulta [Concedere 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**(stringa) — Nome utente di accesso per accedere al sistema operativo (OS) nell'AMI. In genere `ec2-user` per AMI Linux o `Administrator` per Windows.
+ **OperatingSystemName**(stringa): nome del sistema operativo mostrato agli acquirenti.
+ **OperatingSystemVersion**(stringa) — Stringa della versione del sistema operativo mostrata agli acquirenti.
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`ChangeSetId`e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò ha incluso 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 Catalog 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 maggiori 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**
I seguenti errori 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, fare riferimento alla [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 |
| --- | --- |
| PRODOTTO\_NON VALIDO | Usa un prodotto pubblico o limitato esistente. |
| MISSING\_DELIVERY\_OPTION\_IDS | Fornisci almeno un ID dell'opzione di consegna. |
| INVALID\_DELIVERY\_OPTION\_IDS | Fornisci gli ID delle opzioni di consegna che possono essere trovati nel prodotto. ID non trovati: [x] |
| OPZIONI\_DI\_CONSEGNA NON VALIDE | Fornisci gli ID delle opzioni di consegna che appartengono alla stessa versione. |
## Limita una versione
Puoi utilizzare l'API Catalog 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 consegna di una versione limita la versione. La limitazione di una o più opzioni di consegna, ma non tutte, da una versione limita solo le opzioni di consegna di quella versione. Devi sempre avere a disposizione almeno una versione senza restrizioni di un prodotto, quindi non puoi limitare l'ultima versione di un prodotto disponibile al pubblico.
**Nota**
Per maggiori informazioni sulla limitazione delle versioni AMI Marketplace AWS tramite il Portale di gestione Marketplace AWS, consulta [Restrizione di una versione nella Guida](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-restricting-version) del *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 di restrizione. Marketplace AWS le linee guida richiedono che tu continui a offrire assistenza agli acquirenti esistenti per 90 giorni dopo aver limitato la versione. L'AMI verrà contrassegnata come obsoleta dopo che la versione sarà limitata. Per ulteriori informazioni, consulta [Deprecare un'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 per le versioni del AMI-based prodotto che desideri limitare.
+ **DeliveryOptionIds**(matrice di oggetti): elenco di `DeliveryOption` ID per le versioni che desideri limitare. Puoi ottenere l'identificatore univoco di `DeliveryOption` richiamando l'`DescribeEntity`azione sulla versione che stai limitando.
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`ChangeSetId`e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò ha incluso 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 Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Errori asincroni**
I seguenti errori 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 |
| --- | --- |
| PRODOTTO\_INVALIDO | Usa un prodotto pubblico esistente. |
| MISSING\_DELIVERY\_OPTION\_IDS | Fornisci almeno un ID dell'opzione di consegna. |
| INVALID\_DELIVERY\_OPTION\_IDS | Fornisci gli ID delle opzioni di consegna che possono essere trovati nel prodotto. ID non trovati: [x] |
| OPZIONE\_CONSEGNA INVALIDA | Fornisci gli ID delle opzioni di consegna che si trovano in uno stato pubblico. ID non pubblici: [x] |
| ALL\_DELIVERY\_OPTIONS\_RESTRICTED | Fornisci un minor numero di opzioni di consegna da limitare poiché almeno una deve rimanere in stato pubblico. |
## Aggiorna future Regione AWS supporto
Puoi utilizzare l'API Catalog per modificare le future preferenze di Regione AWS supporto per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per ulteriori informazioni sulla modifica del supporto per le future regioni 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, chiamate l'operazione `StartChangeSet` API con il tipo di `UpdateFutureRegionSupport` modifica, come illustrato 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 sui campi in cui aggiungere il tipo di `UpdateFutureRegionSupport` modifica:
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(stringa) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(stringa) (obbligatorio) - `Type` Si basa sul metodo di consegna (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 richiesta. La risposta a questa richiesta fornisce l'`ChangeSetId`e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò ha incluso 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 Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Errori asincroni**
I seguenti errori 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, US o Nessuno |
| REGIONI\_INVALIDE | Le regioni richieste [a, b, c] non sono valide o non disponibili. Solo i valori supportati sono [x, y, z]. |
| INVALID\_INPUT | SupportedRegions non può essere vuoto. |
## Aggiungi un file supportato Regione AWS
Puoi utilizzare l'API Catalog per aggiungere nuovi supporti Regioni AWS per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per ulteriori informazioni sull'aggiunta di nuove regioni supportate utilizzando la 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 *Marketplace AWS Seller Guide*.
**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 illustrato 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 sui campi per aggiungere il tipo di `AddRegions` modifica.
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(stringa) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(stringa) (obbligatorio) - `Type` Si basa sul metodo di consegna (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 richiesta. La risposta a questa richiesta fornisce l'`ChangeSetId`e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò ha incluso 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 Catalog 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`). Puoi utilizzare l'operazione [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeEntity.html](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 correggere l'errore.
**Errori asincroni**
I seguenti errori 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 |
| --- | --- |
| REGIONI\_INVALIDE | Le regioni richieste [a, b, c] non sono valide o non disponibili. Solo i valori supportati sono [x, y, z]. |
| INVALID\_INPUT | Le regioni non possono essere vuote. |
## Limita un Regione AWS
Puoi utilizzare l'API Catalog 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 nella Marketplace AWS](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-restricting-regions) *Seller Guide*.
**Nota**
Il tipo di `RestrictRegions` modifica è disponibile solo su. `AmiProduct@1.0`
Per limitare le regioni precedentemente supportate, chiamate l'operazione `StartChangeSet` API con il tipo di `RestrictRegions` modifica, come illustrato 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 sui campi per aggiungere il tipo di `AddRegions` modifica.
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(stringa) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(stringa) (obbligatorio) - `Type` Si basa sul metodo di consegna (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 richiesta. La risposta a questa richiesta fornisce l'`ChangeSetId`e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò ha incluso 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 Catalog 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`). Puoi utilizzarlo `DescribeEntity` sull'entità del prodotto per verificare il risultato. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeEntity.html](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 correggere l'errore.
**Errori asincroni**
I seguenti errori 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 |
| --- | --- |
| REGIONI\_INVALIDE | Le regioni richieste [a, b, c] non sono valide o non disponibili. Solo i valori supportati sono [x, y, z]. |
| INVALID\_INPUT | Le regioni non possono essere vuote. |
## Aggiungi un nuovo tipo di istanza
Puoi utilizzare l'API Catalog per aggiungere nuovi tipi di istanze per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per maggiori informazioni sull'aggiunta di tipi di istanze 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 al Marketplace AWS venditore*.
`AddInstanceTypes`aggiungerà nuovi tipi di istanze ai prodotti esistenti e ai prodotti appena creati durante la creazione di un prodotto. Il tipo di modifica aggiornerà tutte le versioni nel documento del 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 istanze è intercambiabile e non rappresenta uno stato di restrizione permanente per un prodotto.
Per i prodotti con misurazione interna, i venditori devono richiedere tipi di modifica distinti `AddDimensions` e aggiornare i prezzi `UpdatePricingTerms` per il tipo di istanza.
Per aggiungere nuovi tipi di istanza, richiama l'operazione `StartChangeSet` API con il tipo di `RestrictRegions` modifica, come illustrato nell'esempio seguente.
**Sintassi della richiesta**
Di seguito viene mostrato solo il tipo di `AddInstanceTypes` modifica. Sebbene i venditori di AMI con contabilizzazione interna siano tenuti a chiamare `AddInstanceTypes` e `UpdatePricingTerms` cambiare 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 sui campi in cui aggiungere il `AddInstanceTypes` tipo di modifica:
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(stringa) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(stringa) (obbligatorio) - `Type` Si basa sul metodo di consegna (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+ **DetailsDocument**(oggetto) (obbligatorio): i dettagli necessari per eseguire`ChangeSet`, in questo caso`InstanceTypes`.
+ `InstanceTypes`(array 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 richiesta. La risposta a questa richiesta fornisce l'`ChangeSetId`e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò ha incluso 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 Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Convalide sincrone**
Le convalide dello schema seguenti 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 input | Regola di convalida | HTTP |
| --- | --- | --- |
| InstanceTypes | Richiesto | 422 |
| InstanceTypes | Non deve essere vuoto | 422 |
| InstanceTypes | Le voci devono avere una lunghezza compresa tra 1 e 24 caratteri. Deve corrispondere a ^ [A-Za-z0-9\_.-] \+$ | 422 |
| InstanceTypes | Le voci devono essere uniche | 422 |
| InstanceTypes | Non devono essere più di 1500 iscrizioni | 422 |
| Una proprietà sconosciuta | Non sono consentite proprietà aggiuntive | 422 |
**Errori asincroni**
I seguenti errori 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 è supportata dai seguenti tipi di istanze: [x] |
| INVALID\_AMI\_ARCHITECTURE | L'architettura della CPU del prodotto è '%s'.» \+ «Non è supportata dai seguenti tipi di istanze: [x] |
| SISTEMA\_OPERATING\_INCOMPATIBILE | I tipi di istanza sono incompatibili con il sistema operativo definito nel prodotto. Fornisci tipi di istanze compatibili con il sistema operativo definito nel prodotto. |
| INVALID\_PRODUCT\_TYPE | Utilizza un prodotto AMI singolo esistente. |
| INVALID\_ENA\_SETTING | Il prodotto non supporta ENA. Il supporto ENA è richiesto dai seguenti tipi di istanze: [x] |
| DIMENSIONI\_NON VALIDE | Nessuna dimensione misurata internamente per i tipi di istanza: [x] |
| DIMENSIONI\_MANCANTI | Nessuna dimensione trovata per il prodotto. AddDimensions è richiesto prima AddInstanceTypes. |
| UPDATE\_PRICING\_REQUIRED | UpdatePricingTerms il tipo di modifica è obbligatorio quando sul prodotto sono disponibili dimensioni misurate internamente. |
## Limita un tipo di istanza
Puoi utilizzare l'API Catalog per limitare o limitare i tipi di istanze disponibili per il tuo AMI-based prodotto in Marketplace AWS.
**Nota**
Per maggiori informazioni su come limitare o limitare i tipi di istanze disponibili utilizzando il Portale di gestione Marketplace AWS, consulta [Limita un'istanza](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-single-ami-products.html#single-ami-restricting-instance-types) nella *Guida al 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 potrà utilizzare tipi di istanze con restrizioni. Per interrompere gli abbonamenti ai tipi di istanze attuali (una volta che i tipi di istanze sono stati limitati), devi contattare il Marketplace AWS Seller Operations Team.
`RestrictInstanctTypes`limita i tipi di istanze a tutte le versioni del 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 istanze.
Per un prodotto a contabilizzazione interna, devi chiamare tipi di modifica diversi durante la chiamata. `RestrictDimensions` Ciò impedisce la creazione di nuove offerte per i tipi di istanze con restrizioni.
**Nota**
Il tipo di `RestrictInstanceTypes` modifica è disponibile solo su`AmiProduct@1.0`.
Per limitare o limitare i tipi di istanza disponibili per il AMI-based prodotto, richiama l'operazione `StartChangeSet` API con il tipo di `RestrictInstanceTypes` modifica, come illustrato 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 sui campi per aggiungere il tipo di `RestrictInstanceTypes` modifica.
+ `Entity`(oggetto) (obbligatorio): il tuo AMI-based prodotto.
+ `Identifier`(stringa) (obbligatorio) — L'ID del prodotto. Per ulteriori informazioni, consulta [Identificatore](catalog-apis.md#identifier).
+ `Type`(stringa) (obbligatorio) - `Type` Si basa sul metodo di consegna (tipo di prodotto) che verrà utilizzato dal prodotto:`AmiProduct@1.0`.
+ **DetailsDocument**(oggetto) (obbligatorio): i dettagli necessari per eseguire`ChangeSet`, in questo caso`InstanceTypes`.
+ `InstanceTypes`(array di stringhe) (obbligatorio): elenco `InstanceTypes` da limitare al prodotto. Queste istanze vengono aggiunte a quelle correnti (o se non esistono tipi di istanze esistenti, verranno aggiunte) a quelle limitate. `InstanceTypes`
**Sintassi della risposta**
Viene creato un set di modifiche per la richiesta. La risposta a questa richiesta fornisce l'`ChangeSetId`e `ChangeSetArn` per il set di modifiche ed è simile alla seguente.
```
{
"ChangeSetId": "{{example123456789012abcdef}}",
"ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```
La richiesta di modifica viene aggiunta a una coda ed elaborata. Ciò ha incluso 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 Catalog utilizzando l'operazione `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Convalide sincrone**
Le convalide dello schema seguenti 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 input | Regola di convalida | HTTP |
| --- | --- | --- |
| InstanceTypes | Richiesto | 422 |
| InstanceTypes | Non deve essere vuoto | 422 |
| InstanceTypes | Le voci devono avere una lunghezza compresa tra 1 e 24 caratteri. Deve corrispondere a ^ [A-Za-z0-9\_.-] \+$ | 422 |
| InstanceTypes | Le voci devono essere uniche | 422 |
| InstanceTypes | Non devono essere più di 1500 iscrizioni | 422 |
| Una proprietà sconosciuta | Non sono consentite proprietà aggiuntive | 422 |
**Errori asincroni**
I seguenti errori 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] |
| TIPO\_PRODOTTO NON VALIDO | Utilizza un prodotto AMI singolo esistente. |
| DUPLICATE\_INSTANCE\_TYPE | Fornisci tipi di istanza senza duplicati. |
| UNAVAILABLE\_INSTANCE\_TYPE | Fornite un tipo di istanza disponibile. |
| RECOMMENDED\_INSTANCE\_TYPE\_RESTRICTED | I seguenti tipi di istanze non possono essere limitati. Il tipo di istanza consigliato deve essere cambiato con uno diverso prima di essere limitato. Id delle opzioni di consegna [X] Tipo di istanza [X] |
| DIMENSIONI\_NOT\_LIMITATE | Limita le dimensioni prima di limitare i tipi di istanza con misurazione interna: [x] |
| REGION\_NO\_INSTANCES | I tipi di istanze con restrizioni causerebbero un errore nel lancio del prodotto nella regione: X. Valuta la possibilità di limitare un numero inferiore di istanze. |
| INCOMPATIBLE\_RESTRICTION | I tipi di istanze con restrizioni genererebbero un prodotto senza tipi di istanza basati su FPGA per le AFI. Il prodotto deve supportare almeno un tipo di istanza basata su FPGA. |