

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Conjuntos de cambios de ApplicationID de aplicaciones
<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 de la operación:** `CreateCloudFormationChangeSet`

Crea un conjunto de AWS CloudFormation cambios para la aplicación en cuestión.


**Parámetros de la ruta**  

| Name | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| applicationId | Cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | 


**Respuestas**  

| Código de estado | Modelo de respuesta | Description (Descripción) | 
| --- |--- |--- |
| 201 | ChangeSetDetails | Success | 
| 400 | BadRequestException | Uno de los parámetros de la solicitud no es válido. | 
| 403 | ForbiddenException | El cliente no está autenticado. | 
| 429 | TooManyRequestsException | El cliente envía más solicitudes por unidad de tiempo de las permitidas. | 
| 500 | InternalServerErrorException | El AWS Serverless Application Repository servicio ha detectado un error interno. | 

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


**Parámetros de la ruta**  

| Name | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| applicationId | Cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | 


**Respuestas**  

| Código de estado | Modelo de respuesta | Description (Descripción) | 
| --- |--- |--- |
| 200 | Ninguno | Respuesta de 200 | 

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

### Cuerpos de la solicitud
<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"
    }
  ]
}
```

### Cuerpos de respuesta
<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"
}
```

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

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

Uno de los parámetros de la solicitud no es válido.


| Propiedad | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| errorCode | cadena | False | 400 | 
| message | cadena | False | Uno de los parámetros de la solicitud no es válido. | 

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

Detalles del conjunto de cambios.


| Propiedad | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| applicationId | cadena | True | El nombre de recurso de Amazon (ARN) de la aplicación. | 
| changeSetId | cadena | True | El nombre de recurso de Amazon (ARN) del conjunto de cambios.Limitaciones de longitud: longitud mínima de 1.Patrón: ARN: [-a-za-Z0-9:/] \$1 | 
| semanticVersion | cadena | True | La versión semántica de la aplicación: [https://semver.org/](https://semver.org/)  | 
| stackId | cadena | True | El identificador único de la pila. | 

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

Cree una solicitud de cambio de conjunto de aplicaciones.


| Propiedad | Tipo | Obligatorio | Description (Descripción) | 
| --- |--- |--- |--- |
| capabilities | Matriz de tipo string | False | Una lista de valores que debe especificar antes de poder implementar determinadas aplicaciones. Algunas aplicaciones pueden incluir recursos que pueden afectar a los permisos de su AWS cuenta, por ejemplo, al crear nuevos AWS Identity and Access Management (IAM) usuarios. En el caso de esas aplicaciones, debes reconocer explícitamente sus capacidades especificando este parámetro.Los únicos valores válidos son `CAPABILITY_IAM``CAPABILITY_NAMED_IAM`,`CAPABILITY_RESOURCE_POLICY`, y`CAPABILITY_AUTO_EXPAND`.Los siguientes recursos requieren que especifique `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), y [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html). Si la aplicación contiene recursos de IAM, puede especificar una `CAPABILITY_IAM` o`CAPABILITY_NAMED_IAM`. Si la aplicación contiene recursos de IAM con nombres personalizados, debe especificar `CAPABILITY_NAMED_IAM`.Los siguientes recursos requieren que 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)y [AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html): :SNS:. TopicPolicyLas aplicaciones que contienen una o varias aplicaciones anidadas requieren que especifique `CAPABILITY_AUTO_EXPAND`.Si la plantilla de su aplicación contiene alguno de los recursos anteriores, le recomendamos que revise todos los permisos asociados a la aplicación antes de implementarla. Si no especifica este parámetro para una aplicación que requiere capacidades, la llamada fallará. | 
| changeSetName | cadena | False | Esta propiedad corresponde al parámetro del mismo nombre de la *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| clientToken | cadena | False | Esta propiedad corresponde al parámetro del mismo nombre de la *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| description | cadena | False | Esta propiedad corresponde al parámetro del mismo nombre de la *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| notificationArns | Matriz de tipo string | False | Esta propiedad corresponde al parámetro del mismo nombre de la *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| parameterOverrides | Matriz de tipo [ParameterValue](#applications-applicationid-changesets-model-parametervalue) | False | Una lista de valores de parámetros para los parámetros de la aplicación. | 
| resourceTypes | Matriz de tipo string | False | Esta propiedad corresponde al parámetro del mismo nombre de la *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| rollbackConfiguration | [RollbackConfiguration](#applications-applicationid-changesets-model-rollbackconfiguration) | False | Esta propiedad corresponde al parámetro del mismo nombre de la *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| semanticVersion | cadena | False | La versión semántica de la aplicación: [https://semver.org/](https://semver.org/)  | 
| stackName | cadena | True | Esta propiedad corresponde al parámetro del mismo nombre de la *CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| tags | Matriz de tipo [Tag](#applications-applicationid-changesets-model-tag) | False | Esta propiedad corresponde al parámetro del mismo nombre de la *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| templateId | cadena | False | El UUID devuelto por CreateCloudFormationTemplate.Patrón: [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>

El cliente no está autenticado.


| Propiedad | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| errorCode | cadena | False | 403 | 
| message | cadena | False | El cliente no está autenticado. | 

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

El AWS Serverless Application Repository servicio ha detectado un error interno.


| Propiedad | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| errorCode | cadena | False | 500 | 
| message | cadena | False | El AWS Serverless Application Repository servicio ha detectado un error interno. | 

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

Valor del parámetro de la aplicación.


| Propiedad | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| name | cadena | True | La clave asociada con el parámetro. Si no especifica una clave y un valor para un parámetro concreto, CloudFormation utiliza el valor predeterminado que se especifica en la plantilla. | 
| value | cadena | True | El valor de entrada asociado con el parámetro. | 

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

Esta propiedad corresponde al tipo *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*de datos.


| Propiedad | Tipo | Obligatorio | Description (Descripción) | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | entero | False | Esta propiedad corresponde al contenido del mismo nombre para el tipo *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*de datos. | 
| rollbackTriggers | Matriz de tipo [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) | False | Esta propiedad corresponde al contenido del mismo nombre para el tipo *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*de datos. | 

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

Esta propiedad corresponde al tipo *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*de datos.


| Propiedad | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| arn | cadena | True | Esta propiedad corresponde al contenido del mismo nombre para el tipo *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*de datos. | 
| type | cadena | True | Esta propiedad corresponde al contenido del mismo nombre para el tipo *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*de datos. | 

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

Esta propiedad corresponde al tipo de datos de la *CloudFormation [etiqueta](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*.


| Propiedad | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| key | cadena | True | Esta propiedad corresponde al contenido del mismo nombre para el tipo de datos de la *AWS CloudFormation [etiqueta](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 
| value | cadena | True | Esta propiedad corresponde al contenido del mismo nombre para el tipo de datos de la *AWS CloudFormation [etiqueta](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 

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

El cliente envía más solicitudes por unidad de tiempo de las permitidas.


| Propiedad | Tipo | Obligatorio | Descripción | 
| --- |--- |--- |--- |
| errorCode | cadena | False | 429 | 
| message | cadena | False | El cliente envía más solicitudes de las permitidas por unidad de tiempo. | 

## Véase también
<a name="applications-applicationid-changesets-see-also"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs y las referencias, consulta lo siguiente:

### CreateCloudFormationChangeSet
<a name="CreateCloudFormationChangeSet-see-also"></a>
+ [Interfaz de línea de comandos de AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para la JavaScript versión 3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK de AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK de AWS 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)