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 ApplicationID Changesets
<a name="applications-applicationid-changesets"></a>

## URI
<a name="applications-applicationid-changesets-url"></a>

`/applications/applicationId/changesets`

## Metodi HTTP
<a name="applications-applicationid-changesets-http-methods"></a>

### POST
<a name="applications-applicationid-changesetspost"></a>

**ID dell'operazione:** `CreateCloudFormationChangeSet`

Crea un set di AWS CloudFormation modifiche per l'applicazione specificata.


**Parametri del percorso**  

| Name | Tipo | Campo obbligatorio | Descrizione | 
| --- |--- |--- |--- |
| applicationId | Stringa | True | Il nome della risorsa Amazon (ARN) dell'applicazione. | 


**Risposte**  

| Codice di stato | Modello di risposta | Description | 
| --- |--- |--- |
| 201 | ChangeSetDetails | Completato | 
| 400 | BadRequestException | Uno dei parametri della richiesta non è valido. | 
| 403 | ForbiddenException | Il client non è autenticato. | 
| 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
<a name="applications-applicationid-changesetsoptions"></a>


**Parametri del percorso**  

| Name | Tipo | Campo obbligatorio | Descrizione | 
| --- |--- |--- |--- |
| applicationId | Stringa | True | Il nome della risorsa Amazon (ARN) dell'applicazione. | 


**Risposte**  

| Codice di stato | Modello di risposta | Description | 
| --- |--- |--- |
| 200 | Nessuno | Risposta 200 | 

## Schemi
<a name="applications-applicationid-changesets-schemas"></a>

### Corpi della richiesta
<a name="applications-applicationid-changesets-request-examples"></a>

#### Schema POST
<a name="applications-applicationid-changesets-request-body-post-example"></a>

```
{
  "stackName": "string",
  "semanticVersion": "string",
  "templateId": "string",
  "parameterOverrides": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "capabilities": [
    "string"
  ],
  "changeSetName": "string",
  "clientToken": "string",
  "description": "string",
  "notificationArns": [
    "string"
  ],
  "resourceTypes": [
    "string"
  ],
  "rollbackConfiguration": {
    "rollbackTriggers": [
      {
        "arn": "string",
        "type": "string"
      }
    ],
    "monitoringTimeInMinutes": integer
  },
  "tags": [
    {
      "key": "string",
      "value": "string"
    }
  ]
}
```

### Corpi della risposta
<a name="applications-applicationid-changesets-response-examples"></a>

#### Schema ChangeSetDetails
<a name="applications-applicationid-changesets-response-body-changesetdetails-example"></a>

```
{
  "applicationId": "string",
  "semanticVersion": "string",
  "changeSetId": "string",
  "stackId": "string"
}
```

#### Schema BadRequestException
<a name="applications-applicationid-changesets-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Schema ForbiddenException
<a name="applications-applicationid-changesets-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Schema TooManyRequestsException
<a name="applications-applicationid-changesets-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Schema InternalServerErrorException
<a name="applications-applicationid-changesets-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Properties
<a name="applications-applicationid-changesets-properties"></a>

### BadRequestException
<a name="applications-applicationid-changesets-model-badrequestexception"></a>

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. | 

### ChangeSetDetails
<a name="applications-applicationid-changesets-model-changesetdetails"></a>

Dettagli del set di modifiche.


| Proprietà | Tipo | Campo obbligatorio | Descrizione | 
| --- |--- |--- |--- |
| applicationId | stringa | True | L'applicazione Amazon Resource Name (ARN). | 
| changeSetId | stringa | True | L'Amazon Resource Name (ARN) del set di modifiche.Vincoli della lunghezza: lunghezza minima 1.Modello: ARN: [-a-zA-Z0-9:/] \$1 | 
| semanticVersion | stringa | True | La versione semantica dell'applicazione: [https://semver.org/](https://semver.org/)  | 
| stackId | stringa | True | L'ID univoco dello stack. | 

### CreateCloudFormationChangeSetInput
<a name="applications-applicationid-changesets-model-createcloudformationchangesetinput"></a>

Crea una richiesta di set di modifiche all'applicazione.


| Proprietà | Tipo | Campo obbligatorio | Description | 
| --- |--- |--- |--- |
| capabilities | Array di tipo string | False | 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:](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html). TopicPolicyLe 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. | 
| changeSetName | stringa | False | Questa proprietà corrisponde al parametro con lo stesso nome per l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| clientToken | stringa | False | Questa proprietà corrisponde al parametro con lo stesso nome per l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| description | stringa | False | Questa proprietà corrisponde al parametro con lo stesso nome per l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| notificationArns | Array di tipo string | False | Questa proprietà corrisponde al parametro con lo stesso nome per l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| parameterOverrides | Array di tipo [ParameterValue](#applications-applicationid-changesets-model-parametervalue) | False | Un elenco di valori dei parametri per i parametri dell'applicazione. | 
| resourceTypes | Array di tipo string | False | Questa proprietà corrisponde al parametro con lo stesso nome per l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| rollbackConfiguration | [RollbackConfiguration](#applications-applicationid-changesets-model-rollbackconfiguration) | False | Questa proprietà corrisponde al parametro con lo stesso nome per l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| semanticVersion | stringa | False | La versione semantica dell'applicazione: [https://semver.org/](https://semver.org/)  | 
| stackName | stringa | True | Questa proprietà corrisponde al parametro con lo stesso nome per l'*CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| tags | Array di tipo [Tag](#applications-applicationid-changesets-model-tag) | False | Questa proprietà corrisponde al parametro con lo stesso nome per l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| templateId | stringa | False | L'UUID restituito da. CreateCloudFormationTemplateModello: [0-9a-Fa-F] \$18\$1\$1 - [0-9a-fa-F] \$14\$1\$1 - [0-9a-fa-F] \$14\$1\$1 - [0-9a-fa-F] \$14\$1\$1 - [0-9a-fa-F] \$112\$1 | 

### ForbiddenException
<a name="applications-applicationid-changesets-model-forbiddenexception"></a>

Il client non è autenticato.


| Proprietà | Tipo | Campo obbligatorio | Descrizione | 
| --- |--- |--- |--- |
| errorCode | stringa | False | 403 | 
| message | stringa | False | Il client non è autenticato. | 

### InternalServerErrorException
<a name="applications-applicationid-changesets-model-internalservererrorexception"></a>

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. | 

### ParameterValue
<a name="applications-applicationid-changesets-model-parametervalue"></a>

Valore del parametro dell'applicazione.


| Proprietà | Tipo | Campo obbligatorio | Descrizione | 
| --- |--- |--- |--- |
| name | stringa | True | La chiave associata al parametro. Se non specificate una chiave e un valore per un particolare parametro, CloudFormation utilizza il valore predefinito specificato nel modello. | 
| value | stringa | True | Il valore di input associato al parametro. | 

### RollbackConfiguration
<a name="applications-applicationid-changesets-model-rollbackconfiguration"></a>

Questa proprietà corrisponde al tipo di *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*dati.


| Proprietà | Tipo | Campo obbligatorio | Description | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | intero | False | Questa proprietà corrisponde al contenuto dello stesso nome per il tipo di *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*dati. | 
| rollbackTriggers | Array di tipo [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) | False | Questa proprietà corrisponde al contenuto dello stesso nome per il tipo di *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*dati. | 

### RollbackTrigger
<a name="applications-applicationid-changesets-model-rollbacktrigger"></a>

Questa proprietà corrisponde al tipo di *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*dati.


| Proprietà | Tipo | Campo obbligatorio | Descrizione | 
| --- |--- |--- |--- |
| arn | stringa | True | Questa proprietà corrisponde al contenuto dello stesso nome per il tipo di *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*dati. | 
| type | stringa | True | Questa proprietà corrisponde al contenuto dello stesso nome per il tipo di *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*dati. | 

### Tag
<a name="applications-applicationid-changesets-model-tag"></a>

Questa proprietà corrisponde al tipo di dati del *CloudFormation [tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*.


| Proprietà | Tipo | Campo obbligatorio | Descrizione | 
| --- |--- |--- |--- |
| key | stringa | True | Questa proprietà corrisponde al contenuto con lo stesso nome per il tipo di dati del *AWS CloudFormation [tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 
| value | stringa | True | Questa proprietà corrisponde al contenuto con lo stesso nome per il tipo di dati del *AWS CloudFormation [tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 

### TooManyRequestsException
<a name="applications-applicationid-changesets-model-toomanyrequestsexception"></a>

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. | 

## Consulta anche
<a name="applications-applicationid-changesets-see-also"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs e dei riferimenti specifici, consulta quanto segue:

### CreateCloudFormationChangeSet
<a name="CreateCloudFormationChangeSet-see-also"></a>
+ [Interfaccia a riga di comando AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS per.NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS per C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS per Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK per Java](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS per JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS per Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS per PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS per Python](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS per Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)