Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Applications ApplicationID : ensembles de modifications
<a name="applications-applicationid-changesets"></a>

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

`/applications/applicationId/changesets`

## Méthodes HTTP
<a name="applications-applicationid-changesets-http-methods"></a>

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

**ID de l'opération :** `CreateCloudFormationChangeSet`

Crée un ensemble de AWS CloudFormation modifications pour l'application donnée.


**Paramètres de chemin d'accès**  

| Nom | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| applicationId | String | True | Amazon Resource Name (ARN) de l'application. | 


**Réponses**  

| Code de statut | Modèle de réponse | Description | 
| --- |--- |--- |
| 201 | ChangeSetDetails | Réussite | 
| 400 | BadRequestException | L'un des paramètres dans la demande n'est pas valide. | 
| 403 | ForbiddenException | Le client n'est pas authentifié. | 
| 429 | TooManyRequestsException | Le client envoie un nombre de demandes supérieur au nombre autorisé par unité de temps. | 
| 500 | InternalServerErrorException | Le AWS Serverless Application Repository service a rencontré une erreur interne. | 

### OPTIONS
<a name="applications-applicationid-changesetsoptions"></a>


**Paramètres de chemin d'accès**  

| Nom | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| applicationId | String | True | Amazon Resource Name (ARN) de l'application. | 


**Réponses**  

| Code de statut | Modèle de réponse | Description | 
| --- |--- |--- |
| 200 | Aucune | Réponse 200 | 

## Schémas
<a name="applications-applicationid-changesets-schemas"></a>

### Corps de la demande
<a name="applications-applicationid-changesets-request-examples"></a>

#### Schéma 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"
    }
  ]
}
```

### Corps de la réponse
<a name="applications-applicationid-changesets-response-examples"></a>

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

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

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

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

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

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

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

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

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

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

## Propriétés
<a name="applications-applicationid-changesets-properties"></a>

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

L'un des paramètres dans la demande n'est pas valide.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| errorCode | chaîne | False | 400 | 
| message | chaîne | False | L'un des paramètres dans la demande n'est pas valide. | 

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

Détails de l'ensemble de modifications.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| applicationId | chaîne | True | Amazon Resource Name (ARN) de l'application . | 
| changeSetId | chaîne | True | Le nom de ressource Amazon (ARN) de l'ensemble de modifications.Contraintes de longueur : longueur minimale de 1.Modèle : ARN : [-a-Za-Z0-9 :/] \$1 | 
| semanticVersion | chaîne | True | La version sémantique de l'application : [https://semver.org/](https://semver.org/)  | 
| stackId | chaîne | True | L'identifiant unique de la pile. | 

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

Créez une demande d'ensemble de modifications d'application.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| capabilities | Tableau de type string | False | Liste de valeurs que vous devez spécifier avant de pouvoir déployer certaines applications. Certaines applications peuvent inclure des ressources susceptibles d'affecter les autorisations de votre AWS compte, par exemple en créant de nouveaux Gestion des identités et des accès AWS (IAM) utilisateurs. Pour ces applications, vous devez explicitement reconnaître leurs capacités en spécifiant ce paramètre.Les seules valeurs valides sont `CAPABILITY_IAM``CAPABILITY_NAMED_IAM`,`CAPABILITY_RESOURCE_POLICY`, et`CAPABILITY_AUTO_EXPAND`.Les ressources suivantes nécessitent que vous spécifiiez `CAPABILITY_IAM` ou `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), et [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html). Si l'application contient des ressources IAM, vous pouvez spécifier `CAPABILITY_IAM` soit`CAPABILITY_NAMED_IAM`. Si l'application contient des ressources IAM dotées de noms personnalisés, vous devez spécifier `CAPABILITY_NAMED_IAM`.Les ressources suivantes nécessitent que vous spécifiez `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)et [AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html) : :SNS :. TopicPolicyLes applications contenant une ou plusieurs applications imbriquées exigent de spécifier `CAPABILITY_AUTO_EXPAND`.Si votre modèle d'application contient l'une des ressources ci-dessus, nous vous recommandons de vérifier toutes les autorisations associées à l'application avant de procéder au déploiement. Si vous ne spécifiez pas ce paramètre pour une application nécessitant des fonctionnalités, l'appel échouera. | 
| changeSetName | chaîne | False | Cette propriété correspond au paramètre du même nom pour l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| clientToken | chaîne | False | Cette propriété correspond au paramètre du même nom pour l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| description | chaîne | False | Cette propriété correspond au paramètre du même nom pour l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| notificationArns | Tableau de type string | False | Cette propriété correspond au paramètre du même nom pour l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| parameterOverrides | Tableau de type [ParameterValue](#applications-applicationid-changesets-model-parametervalue) | False | Liste des valeurs des paramètres de l'application. | 
| resourceTypes | Tableau de type string | False | Cette propriété correspond au paramètre du même nom pour 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 | Cette propriété correspond au paramètre du même nom pour l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| semanticVersion | chaîne | False | La version sémantique de l'application : [https://semver.org/](https://semver.org/)  | 
| stackName | chaîne | True | Cette propriété correspond au paramètre du même nom pour l'*CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| tags | Tableau de type [Tag](#applications-applicationid-changesets-model-tag) | False | Cette propriété correspond au paramètre du même nom pour l'*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| templateId | chaîne | False | L'UUID renvoyé par. CreateCloudFormationTemplateSchéma : [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>

Le client n'est pas authentifié.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| errorCode | chaîne | False | 403 | 
| message | chaîne | False | Le client n'est pas authentifié. | 

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

Le AWS Serverless Application Repository service a rencontré une erreur interne.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| errorCode | chaîne | False | 500 | 
| message | chaîne | False | Le AWS Serverless Application Repository service a rencontré une erreur interne. | 

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

Valeur du paramètre de l'application.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| name | chaîne | True | Clé associée au paramètre. Si vous ne spécifiez pas de clé ni de valeur pour un paramètre en particulier, CloudFormation utilise la valeur par défaut spécifiée dans votre modèle. | 
| value | chaîne | True | Valeur d'entrée associée au paramètre. | 

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

Cette propriété correspond au type *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*de données.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | integer | False | Cette propriété correspond au contenu du même nom pour le type de *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*données. | 
| rollbackTriggers | Tableau de type [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) | False | Cette propriété correspond au contenu du même nom pour le type de *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*données. | 

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

Cette propriété correspond au type *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*de données.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| arn | chaîne | True | Cette propriété correspond au contenu du même nom pour le type de *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*données. | 
| type | chaîne | True | Cette propriété correspond au contenu du même nom pour le type de *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*données. | 

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

Cette propriété correspond au type de données de *CloudFormation [balise](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| key | chaîne | True | Cette propriété correspond au contenu du même nom pour le type de données de *AWS CloudFormation [balise](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 
| value | chaîne | True | Cette propriété correspond au contenu du même nom pour le type de données de *AWS CloudFormation [balise](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 

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

Le client envoie un nombre de demandes supérieur au nombre autorisé par unité de temps.


| Propriété | Type | Obligatoire | Description | 
| --- |--- |--- |--- |
| errorCode | chaîne | False | 429 | 
| message | chaîne | False | Le client envoie un nombre de demandes supérieur au nombre autorisé par unité de temps. | 

## Consultez aussi
<a name="applications-applicationid-changesets-see-also"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'une des références spécifiques au langage AWS SDKs , consultez ce qui suit :

### CreateCloudFormationChangeSet
<a name="CreateCloudFormationChangeSet-see-also"></a>
+ [Interface de ligne de commande AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [Kit de développement logiciel AWS pour .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [Kit AWS SDK pour C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS pour Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [Kit AWS SDK pour Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK AWS pour V3 JavaScript ](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [Kit de développement logiciel AWS pour Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK pour PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK pour Python](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK pour Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)