As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Aplicativos ApplicationID Changesets
<a name="applications-applicationid-changesets"></a>

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

`/applications/applicationId/changesets`

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

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

**ID da operação:** `CreateCloudFormationChangeSet`

Cria um conjunto de AWS CloudFormation alterações para o aplicativo em questão.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 201 | ChangeSetDetails | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

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


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

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

### Corpos da solicitação
<a name="applications-applicationid-changesets-request-examples"></a>

#### Esquema 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"
    }
  ]
}
```

### Corpos da resposta
<a name="applications-applicationid-changesets-response-examples"></a>

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

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

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

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

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

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

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

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

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

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

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

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

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

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

Detalhes do conjunto de alterações.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| changeSetId | string | Verdadeiro | O Amazon Resource Name (ARN) do conjunto de alterações.Restrições de tamanho: tamanho mínimo 1.Padrão: ARN: [-a-zA-z0-9:/] \$1 | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| stackId | string | Verdadeiro | O ID exclusivo da pilha. | 

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

Crie uma solicitação de conjunto de alterações do aplicativo.


| Propriedade | Tipo | Obrigatório | Description | 
| --- |--- |--- |--- |
| capabilities | Matriz do tipo string | Falso | Uma lista de valores que você deve especificar antes de poder implantar determinados aplicativos. Alguns aplicativos podem incluir recursos que podem afetar as permissões em sua AWS conta, por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro.Os únicos valores válidos são `CAPABILITY_IAM` `CAPABILITY_NAMED_IAM``CAPABILITY_RESOURCE_POLICY`,, `CAPABILITY_AUTO_EXPAND` e.Os recursos a seguir exigem que você especifique `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`: [AWS::IAM::Group[AWS::IAM::InstanceProfile[AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html)](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::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)e. Se o aplicativo contiver recursos do IAM, você poderá especificar `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`. Se o aplicativo contém recursos do IAM com nomes personalizados, você deverá especificar `CAPABILITY_NAMED_IAM`.Os recursos a seguir exigem que você especifique`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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html): :SNS:. TopicPolicyOs aplicativos que contêm um ou mais aplicativos aninhados exigem que você especifique `CAPABILITY_AUTO_EXPAND`.Se seu modelo de aplicativo contiver algum dos recursos acima, recomendamos que você revise todas as permissões associadas ao aplicativo antes da implantação. Se você não especificar esse parâmetro para um aplicativo que requer recursos, a chamada falhará. | 
| changeSetName | string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| clientToken | string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| description | string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| notificationArns | Matriz do tipo string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| parameterOverrides | Matriz do tipo [ParameterValue](#applications-applicationid-changesets-model-parametervalue) | Falso | Uma lista de valores de parâmetros para os parâmetros do aplicativo. | 
| resourceTypes | Matriz do tipo string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| rollbackConfiguration | [RollbackConfiguration](#applications-applicationid-changesets-model-rollbackconfiguration) | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| semanticVersion | string | Falso | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| stackName | string | Verdadeiro | Essa propriedade corresponde ao parâmetro com o mesmo nome da *CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| tags | Matriz do tipo [Tag](#applications-applicationid-changesets-model-tag) | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| templateId | string | Falso | O UUID retornado por. CreateCloudFormationTemplatePadrão: [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>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

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

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

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

Valor do parâmetro do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| name | string | Verdadeiro | A chave associada ao parâmetro. Se você não especificar uma chave e um valor para um parâmetro específico, CloudFormation usa o valor padrão especificado no seu modelo. | 
| value | string | Verdadeiro | O valor de entrada associado ao parâmetro. | 

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

Essa propriedade corresponde ao Tipo *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*de dados.


| Propriedade | Tipo | Obrigatório | Description | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | integer | Falso | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*dados. | 
| rollbackTriggers | Matriz do tipo [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) | Falso | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*dados. | 

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

Essa propriedade corresponde ao Tipo *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*de dados.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| arn | string | Verdadeiro | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*dados. | 
| type | string | Verdadeiro | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*dados. | 

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

Essa propriedade corresponde ao Tipo de Dados da *CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| key | string | Verdadeiro | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de Dados da *AWS CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 
| value | string | Verdadeiro | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de Dados da *AWS CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 

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

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

## Consulte também
<a name="applications-applicationid-changesets-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

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