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à. # Applicazioni ApplicationID Versions SemanticVersion ## URI `/applications/applicationId/versions/semanticVersion` ## Metodi HTTP ### PUT **ID dell'operazione:** `CreateApplicationVersion` Crea una versione dell'applicazione. **Parametri del percorso** | Name | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | applicationId | Stringa | True | Il nome della risorsa Amazon (ARN) dell'applicazione. | | semanticVersion | Stringa | True | La versione semantica della nuova versione. | **Risposte** | Codice di stato | Modello di risposta | Description | | --- |--- |--- | | 201 | Version | 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 **Parametri del percorso** | Name | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | applicationId | Stringa | True | Il nome della risorsa Amazon (ARN) dell'applicazione. | | semanticVersion | Stringa | True | La versione semantica della nuova versione. | **Risposte** | Codice di stato | Modello di risposta | Description | | --- |--- |--- | | 200 | Nessuno | 200 risposte | ## Schemi ### Corpi della richiesta #### Schema PUT ``` { "templateBody": "string", "templateUrl": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string" } ``` ### Corpi della risposta #### Schema 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 ConflictException ``` { "message": "string", "errorCode": "string" } ``` #### Schema TooManyRequestsException ``` { "message": "string", "errorCode": "string" } ``` #### Schema InternalServerErrorException ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### 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à. | ### CreateApplicationVersionInput Crea una richiesta di versione. | Proprietà | Tipo | Campo obbligatorio | Descrizione | | --- |--- |--- |--- | | 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. | | templateBody | stringa | False | Il AWS SAM modello non elaborato della tua applicazione. | | templateUrl | stringa | False | Un link al AWS SAM modello confezionato dell'applicazione. | ### 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. | ### 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-applicationid-versions-semanticversion-model-parameterdefinition) | True | Una serie di tipi di parametri supportati dall'applicazione. | | requiredCapabilities | Array di tipo [Capability](#applications-applicationid-versions-semanticversion-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: ### CreateApplicationVersion + [Interfaccia a riga di comando AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [SDK AWS per.NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplicationVersion) + [SDK AWS per C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplicationVersion) + [SDK AWS per Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS SDK per Java](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [SDK AWS per JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [SDK AWS per Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplicationVersion) + [SDK AWS per PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [SDK AWS per Python](/goto/boto3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [SDK AWS per Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplicationVersion)