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à. # Applications ## URI `/applications` ## Metodi HTTP ### GET **ID dell'operazione:** `ListApplications` Elenca le applicazioni di proprietà del richiedente. **Parametri di query** | Name | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | maxItems | Stringa | False | Il numero totale di articoli da restituire. | | nextToken | Stringa | False | Token per specificare dove iniziare l'impaginazione. | **Risposte** | Codice di stato | Modello di risposta | Description | | --- |--- |--- | | 200 | ApplicationPage | Completato | | 400 | BadRequestException | Uno dei parametri della richiesta non è valido. | | 403 | ForbiddenException | Il client non è autenticato. | | 404 | NotFoundException | La risorsa (ad esempio, una dichiarazione sulla politica di accesso) specificata nella richiesta non esiste. | | 500 | InternalServerErrorException | Il AWS Serverless Application Repository servizio ha riscontrato un errore interno. | ### POST **ID dell'operazione:** `CreateApplication` Crea un'applicazione, includendo facoltativamente un file AWS SAM per creare la prima versione dell'applicazione nella stessa chiamata. **Risposte** | Codice di stato | Modello di risposta | Description | | --- |--- |--- | | 201 | Application | Completato | | 400 | BadRequestException | Uno dei parametri della richiesta non è valido. | | 403 | ForbiddenException | Il client non è autenticato. | | 409 | ConflictException | La risorsa esiste già. | | 429 | TooManyRequestsException | Il client invia un numero di richieste superiore a quello consentito per unità di tempo. | | 500 | InternalServerErrorException | Il AWS Serverless Application Repository servizio ha riscontrato un errore interno. | ### OPTIONS **Risposte** | Codice di stato | Modello di risposta | Description | | --- |--- |--- | | 200 | Nessuno | Risposta 200 | ## Schemi ### Corpi della richiesta #### Schema POST ``` { "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "licenseBody": "string", "licenseUrl": "string", "readmeBody": "string", "readmeUrl": "string", "labels": [ "string" ], "homePageUrl": "string", "semanticVersion": "string", "templateBody": "string", "templateUrl": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string" } ``` ### Corpi della risposta #### Schema ApplicationPage ``` { "applications": [ { "applicationId": "string", "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string" } ], "nextToken": "string" } ``` #### Schema Application ``` { "applicationId": "string", "name": "string", "description": "string", "author": "string", "isVerifiedAuthor": boolean, "verifiedAuthorUrl": "string", "spdxLicenseId": "string", "licenseUrl": "string", "readmeUrl": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string", "version": { "applicationId": "string", "semanticVersion": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string", "templateUrl": "string", "creationTime": "string", "parameterDefinitions": [ { "name": "string", "defaultValue": "string", "description": "string", "type": "string", "noEcho": boolean, "allowedPattern": "string", "constraintDescription": "string", "minValue": integer, "maxValue": integer, "minLength": integer, "maxLength": integer, "allowedValues": [ "string" ], "referencedByResources": [ "string" ] } ], "requiredCapabilities": [ enum ], "resourcesSupported": boolean } } ``` #### Schema BadRequestException ``` { "message": "string", "errorCode": "string" } ``` #### Schema ForbiddenException ``` { "message": "string", "errorCode": "string" } ``` #### Schema NotFoundException ``` { "message": "string", "errorCode": "string" } ``` #### Schema ConflictException ``` { "message": "string", "errorCode": "string" } ``` #### Schema TooManyRequestsException ``` { "message": "string", "errorCode": "string" } ``` #### Schema InternalServerErrorException ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### Application Dettagli sull'applicazione. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | applicationId | stringa | True | L'applicazione Amazon Resource Name (ARN). | | author | stringa | True | Il nome dell'autore che pubblica l'app.Lunghezza minima = 1. Lunghezza massima = 127.Modello «^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1»; | | creationTime | stringa | False | La data e l'ora di creazione di questa risorsa. | | description | stringa | True | Descrizione dell'applicazione.Lunghezza minima = 1. Lunghezza massima = 256 | | homePageUrl | stringa | False | Un URL con ulteriori informazioni sull'applicazione, ad esempio la posizione del GitHub repository dell'applicazione. | | isVerifiedAuthor | booleano | False | Speciifica se l'autore di questa applicazione è stato verificato. Ciò significa che AWS ha esaminato in buona fede, in qualità di fornitore di servizi ragionevole e prudente, le informazioni fornite dal richiedente e ha confermato che l'identità del richiedente corrisponde a quella dichiarata. | | labels | Array di tipo string | False | Etichette per migliorare la scoperta delle app nei risultati di ricerca.Lunghezza minima = 1. Lunghezza massima = 127. Numero massimo di etichette: 10Modello: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseUrl | stringa | False | Un link a un file di licenza dell'app che corrisponde al valore spdxLicenseID dell'applicazione.Dimensione massima 5 MB | | name | stringa | True | Il nome dell'applicazione.Lunghezza minima = 1. Lunghezza massima = 140Modello: "[a-zA-Z0-9\$1\$1-]\$1"; | | readmeUrl | stringa | False | Un collegamento al file readme in linguaggio Markdown che contiene una descrizione più dettagliata dell'applicazione e del suo funzionamento.Dimensione massima 5 MB | | spdxLicenseId | stringa | False | Un identificatore valido proveniente da https://spdx.org/licenses/. | | verifiedAuthorUrl | stringa | False | L'URL del profilo pubblico di un autore verificato. Questo URL è stato inviato dall'autore. | | version | [Versione](#applications-model-version) | False | Informazioni sulla versione dell'applicazione. | ### ApplicationPage Un elenco di dettagli dell'applicazione. | Proprietà | Tipo | Campo obbligatorio | Description | | --- |--- |--- |--- | | applications | Array di tipo [ApplicationSummary](#applications-model-applicationsummary) | True | Una serie di riepiloghi delle applicazioni. | | nextToken | stringa | False | Il token per richiedere la pagina successiva di risultati. | ### ApplicationSummary Riepilogo dei dettagli sull'applicazione. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | applicationId | stringa | True | L'applicazione Amazon Resource Name (ARN). | | author | stringa | True | Il nome dell'autore che pubblica l'app.Lunghezza minima = 1. Lunghezza massima = 127.Modello «^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1»; | | creationTime | stringa | False | La data e l'ora di creazione di questa risorsa. | | description | stringa | True | Descrizione dell'applicazione.Lunghezza minima = 1. Lunghezza massima = 256 | | homePageUrl | stringa | False | Un URL con ulteriori informazioni sull'applicazione, ad esempio la posizione del GitHub repository dell'applicazione. | | labels | Array di tipo string | False | Etichette per migliorare la scoperta delle app nei risultati di ricerca.Lunghezza minima = 1. Lunghezza massima = 127. Numero massimo di etichette: 10Modello: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | name | stringa | True | Il nome dell'applicazione.Lunghezza minima = 1. Lunghezza massima=140Modello: "[a-zA-Z0-9\$1\$1-]\$1"; | | spdxLicenseId | stringa | False | [Un identificatore valido proveniente da https://spdx.org/licenses/.](https://spdx.org/licenses/) | ### BadRequestException Uno dei parametri della richiesta non è valido. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | errorCode | stringa | False | 400 | | message | stringa | False | Uno dei parametri della richiesta non è valido. | ### Capability Valori che devono essere specificati per distribuire alcune applicazioni. + `CAPABILITY_IAM` + `CAPABILITY_NAMED_IAM` + `CAPABILITY_AUTO_EXPAND` + `CAPABILITY_RESOURCE_POLICY` ### ConflictException La risorsa esiste già. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | errorCode | stringa | False | 409 | | message | stringa | False | La risorsa esiste già. | ### CreateApplicationInput Crea una richiesta di applicazione. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | author | stringa | True | Il nome dell'autore che pubblica l'app.Lunghezza minima = 1. Lunghezza massima = 127.Modello «^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1»; | | description | stringa | True | Descrizione dell'applicazione.Lunghezza minima = 1. Lunghezza massima = 256 | | homePageUrl | stringa | False | Un URL con ulteriori informazioni sull'applicazione, ad esempio la posizione del GitHub repository dell'applicazione. | | labels | Array di tipo string | False | Etichette per migliorare la scoperta delle app nei risultati di ricerca.Lunghezza minima = 1. Lunghezza massima = 127. Numero massimo di etichette: 10Modello: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseBody | stringa | False | Un file di testo locale che contiene la licenza dell'app che corrisponde al valore spdxLicenseID dell'applicazione. Il file ha il formato. `file:///`Dimensione massima 5 MBÈ possibile specificare solo uno degli `licenseBody` e`licenseUrl`; in caso contrario, si verificherà un errore. | | licenseUrl | stringa | False | Un link all'oggetto S3 che contiene la licenza dell'app che corrisponde al valore spdxLicenseID dell'applicazione.Dimensione massima 5 MBÈ possibile specificare solo uno degli `licenseBody` e`licenseUrl`; in caso contrario, si verificherà un errore. | | name | stringa | True | Il nome dell'applicazione che si desidera pubblicare.Lunghezza minima = 1. Lunghezza massima = 140Modello: "[a-zA-Z0-9\$1\$1-]\$1"; | | readmeBody | stringa | False | Un file readme di testo locale in linguaggio Markdown che contiene una descrizione più dettagliata dell'applicazione e del suo funzionamento. Il file ha il formato. `file:///`Dimensione massima 5 MBÈ possibile specificare solo uno degli `readmeBody` e`readmeUrl`; in caso contrario, si verificherà un errore. | | readmeUrl | stringa | False | Un collegamento all'oggetto S3 in linguaggio Markdown che contiene una descrizione più dettagliata dell'applicazione e del suo funzionamento.Dimensione massima 5 MBÈ possibile specificare solo uno degli `readmeBody` e`readmeUrl`; in caso contrario, si verificherà un errore. | | semanticVersion | stringa | False | La versione semantica dell'applicazione: [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | stringa | False | Un link all'oggetto S3 che contiene l'archivio ZIP del codice sorgente per questa versione dell'applicazione.Dimensione massima 50 MB | | sourceCodeUrl | stringa | False | Un link a un archivio pubblico per il codice sorgente dell'applicazione, ad esempio l'URL di un GitHub commit specifico. | | spdxLicenseId | stringa | False | [Un identificatore valido da https://spdx.org/licenses/.](https://spdx.org/licenses/) | | templateBody | stringa | False | Il file AWS SAM modello locale non elaborato dell'applicazione. Il file ha il formato`file:///`.È possibile specificare solo uno degli `templateBody` e`templateUrl`; in caso contrario si verificherà un errore. | | templateUrl | stringa | False | Un link all'oggetto S3 contenente il AWS SAM modello confezionato dell'applicazione.È possibile specificare solo uno degli `templateBody` e`templateUrl`; in caso contrario si verificherà un errore. | ### ForbiddenException Il client non è autenticato. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | errorCode | stringa | False | 403 | | message | stringa | False | Il client non è autenticato. | ### InternalServerErrorException Il AWS Serverless Application Repository servizio ha rilevato un errore interno. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | errorCode | stringa | False | 500 | | message | stringa | False | Il AWS Serverless Application Repository servizio ha riscontrato un errore interno. | ### NotFoundException La risorsa (ad esempio, una dichiarazione sulla politica di accesso) specificata nella richiesta non esiste. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | errorCode | stringa | False | 404 | | message | stringa | False | La risorsa (ad esempio, una dichiarazione sulla politica di accesso) specificata nella richiesta non esiste. | ### ParameterDefinition Parametri supportati dall'applicazione. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | allowedPattern | stringa | False | Espressione regolare che rappresenta i modelli da consentire per i tipi `String`. | | allowedValues | Array di tipo string | False | Matrice contenente l’elenco dei valori consentiti per il parametro. | | constraintDescription | stringa | False | Stringa che illustra un vincolo in caso di violazione del vincolo. Ad esempio, senza una descrizione del vincolo, un parametro associato al modello consentito `[A-Za-z0-9]+` restituisce il seguente messaggio di errore quando l’utente specifica un valore non valido: `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` Aggiungendo una descrizione del vincolo, ad esempio «deve contenere solo lettere e numeri maiuscoli e minuscoli», è possibile visualizzare il seguente messaggio di errore personalizzato: `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.` | | defaultValue | stringa | False | Valore del tipo appropriato per il modello da utilizzare se non viene specificato alcun valore al momento della creazione di uno stack. Se per il parametro definisci vincoli, devi specificare un valore conforme a tali vincoli. | | description | stringa | False | Una stringa di massimo 4.000 caratteri che descrive il parametro. | | maxLength | intero | False | Un valore intero che determina il maggior numero di caratteri che si desidera consentire per `String` i tipi. | | maxValue | intero | False | Un valore numerico che determina il valore numerico massimo consentito per i tipi. `Number` | | minLength | intero | False | Un valore intero che determina il numero minimo di caratteri che si desidera consentire per i tipi. `String` | | minValue | intero | False | Un valore numerico che determina il valore numerico più piccolo che si desidera consentire per i tipi. `Number` | | name | stringa | True | Nome del parametro. | | noEcho | booleano | False | Indica se mascherare il valore del parametro ogni volta che qualcuno effettua una chiamata che descrive lo stack. Se impostate il valore su true, il valore del parametro viene mascherato da asterischi (\$1\$1\$1\$1\$1). | | referencedByResources | Array di tipo string | True | Un elenco di AWS SAM risorse che utilizzano questo parametro. | | type | stringa | False | Il tipo di parametro.Valori validi: `String \| Number \| List \| CommaDelimitedList` `String`: Una stringa letterale.Ad esempio, gli utenti possono specificare`"MyUserName"`. `Number`: Un numero intero o float. CloudFormation convalida il valore del parametro come numero. Tuttavia, quando si utilizza il parametro altrove nel modello (ad esempio, utilizzando la funzione `Ref` intrinseca), il valore del parametro diventa una stringa.Ad esempio, gli utenti potrebbero specificare. `"8888"` `List`: Una matrice di numeri interi o float separati da virgole. CloudFormation convalida il valore del parametro come numeri. Tuttavia, quando si utilizza il parametro altrove nel modello (ad esempio, utilizzando la funzione `Ref` intrinseca), il valore del parametro diventa un elenco di stringhe.Ad esempio, gli utenti potrebbero specificare «80,20" e quindi ottenere il risultato. `Ref` `["80","20"]` `CommaDelimitedList`: matrice di stringhe letterali separate da virgole. Il numero totale di stringhe deve corrispondere al numero totale di virgole più uno. Inoltre, ogni stringa membro è limitata a spazi.Ad esempio, gli utenti potrebbero specificare «test, dev, prod» e quindi ottenere risultati. `Ref` `["test","dev","prod"]` | ### TooManyRequestsException Il client invia più del numero consentito di richieste per unità di tempo. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | errorCode | stringa | False | 429 | | message | stringa | False | Il client invia più del numero consentito di richieste per unità di tempo. | ### Version Dettagli sulla versione dell'applicazione. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | applicationId | stringa | True | L'applicazione Amazon Resource Name (ARN). | | creationTime | stringa | True | La data e l'ora di creazione di questa risorsa. | | parameterDefinitions | Array di tipo [ParameterDefinition](#applications-model-parameterdefinition) | True | Una serie di tipi di parametri supportati dall'applicazione. | | requiredCapabilities | Array di tipo [Capability](#applications-model-capability) | True | Un elenco di valori che è necessario specificare prima di poter distribuire determinate applicazioni. Alcune applicazioni potrebbero includere risorse che possono influire sulle autorizzazioni AWS dell'account, ad esempio creando nuovi AWS Identity and Access Management (IAM) utenti. Per tali applicazioni, è necessario riconoscerne esplicitamente le funzionalità specificando questo parametro.Gli unici valori validi sono`CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM``CAPABILITY_RESOURCE_POLICY`, e. `CAPABILITY_AUTO_EXPAND`Le seguenti risorse richiedono di specificare `CAPABILITY_IAM` o`CAPABILITY_NAMED_IAM`: [AWS::IAM::Group[AWS::IAM::InstanceProfile](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html), [AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html), e [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html). Se l'applicazione contiene risorse IAM, puoi specificare `CAPABILITY_IAM` o`CAPABILITY_NAMED_IAM`. Se l'applicazione include risorse IAM con nomi personalizzati, devi specificare `CAPABILITY_NAMED_IAM`.Le seguenti risorse richiedono di specificare`CAPABILITY_RESOURCE_POLICY`: [AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS: :iam:Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html),, [AWS::ApplicationAutoScaling::ScalingPolicy[AWS::S3::BucketPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), [AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)e. [AWS::SNS::TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html)Le applicazioni che includono una o più applicazioni nidificate richiedono di specificare `CAPABILITY_AUTO_EXPAND`.Se il modello di applicazione contiene una delle risorse di cui sopra, ti consigliamo di rivedere tutte le autorizzazioni associate all'applicazione prima della distribuzione. Se non si specifica questo parametro per un'applicazione che richiede funzionalità, la chiamata avrà esito negativo. | | resourcesSupported | booleano | True | Se tutte le AWS risorse contenute in questa applicazione sono supportate nella regione in cui viene recuperata. | | semanticVersion | stringa | True | La versione semantica dell'applicazione: [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | stringa | False | Un link all'oggetto S3 che contiene l'archivio ZIP del codice sorgente per questa versione dell'applicazione.Dimensione massima 50 MB | | sourceCodeUrl | stringa | False | Un link a un archivio pubblico per il codice sorgente dell'applicazione, ad esempio l'URL di un GitHub commit specifico. | | templateUrl | stringa | True | Un link al AWS SAM modello confezionato dell'applicazione. | ## Consulta anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs e dei riferimenti specifici, consulta quanto segue: ### ListApplications + [Interfaccia a riga di comando AWS V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS per.NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS per C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS per Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplications) + [AWS SDK per Java](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS per JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS per Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS per PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS per Python](/goto/boto3/serverlessrepo-2017-09-08/ListApplications) + [SDK AWS per Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplications) ### CreateApplication + [Interfaccia a riga di comando AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS per.NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS per C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS per Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplication) + [AWS SDK per Java](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS per JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS per Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS per PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS per Python](/goto/boto3/serverlessrepo-2017-09-08/CreateApplication) + [SDK AWS per Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplication)