View a markdown version of this page

Conjuntos de cambios de ID de aplicación de aplicaciones - AWS Serverless Application Repository

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 ID de aplicación de aplicaciones

URI

/applications/applicationId/changesets

Métodos HTTP

POST

ID de la operación: CreateCloudFormationChangeSet

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

Parámetros de la ruta
NameTipoObligatorioDescripción
applicationIdCadenaTrue

El nombre de recurso de Amazon (ARN) de la aplicación.

Respuestas
Código de estadoModelo de respuestaDescription (Descripción)
201ChangeSetDetails

Success

400BadRequestException

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

403ForbiddenException

El cliente no está autenticado.

429TooManyRequestsException

El cliente envía más solicitudes del permitido por unidad de tiempo.

500InternalServerErrorException

El AWS Serverless Application Repository servicio detectó un error interno.

OPCIONES

Parámetros de la ruta
NameTipoObligatorioDescripción
applicationIdCadenaTrue

El nombre de recurso de Amazon (ARN) de la aplicación.

Respuestas
Código de estadoModelo de respuestaDescription (Descripción)
200Ninguno

Respuesta de 200

Esquemas

Cuerpos de la solicitud

{ "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

{ "applicationId": "string", "semanticVersion": "string", "changeSetId": "string", "stackId": "string" }
{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

Propiedades

BadRequestException

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

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

400

message

cadena

False

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

ChangeSetDetails

Detalles del conjunto de cambios.

PropiedadTipoObligatorioDescripció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:/] *

semanticVersion

cadena

True

La versión semántica de la aplicación:

https://semver.org/

stackId

cadena

True

El identificador único de la pila.

CreateCloudFormationChangeSetInput

Cree una solicitud de conjunto de cambios de aplicaciones.

PropiedadTipoObligatorioDescription (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 tu AWS cuenta, por ejemplo, al crear nuevos AWS Identity and Access Management (IAM) usuarios. Para esas aplicaciones, debes reconocer explícitamente sus capacidades especificando este parámetro.

Los únicos valores válidos son CAPABILITY_IAMCAPABILITY_NAMED_IAM,CAPABILITY_RESOURCE_POLICY, yCAPABILITY_AUTO_EXPAND.

Los siguientes recursos requieren que especifique CAPABILITY_IAM oCAPABILITY_NAMED_IAM: AWS: :IAM: :Group, AWS: :IAM::, AWS: :IAM: InstanceProfile :Policy 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 o. CAPABILITY_IAM CAPABILITY_NAMED_IAM Si la aplicación contiene recursos de IAM con nombres personalizados, debe especificar CAPABILITY_NAMED_IAM.

Los siguientes recursos requieren que especifiquesCAPABILITY_RESOURCE_POLICY: AWS::Lambda:: Permission, AWS: AWS::ApplicationAutoScaling: IAM:Policy ScalingPolicy, AWS: :S3:: BucketPolicy, AWS: :SQS:: y AWS:: QueuePolicy. SNS:TopicPolicy

Las 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 especificas 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 para la AWS CloudFormation CreateChangeSet API.

clientToken

cadena

False

Esta propiedad corresponde al parámetro del mismo nombre para la AWS CloudFormation CreateChangeSet API.

description

cadena

False

Esta propiedad corresponde al parámetro del mismo nombre para la AWS CloudFormation CreateChangeSet API.

notificationArns

Matriz de tipo string

False

Esta propiedad corresponde al parámetro del mismo nombre para la AWS CloudFormation CreateChangeSet API.

parameterOverrides

Matriz de tipo 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 para la AWS CloudFormation CreateChangeSet API.

rollbackConfiguration

RollbackConfiguration

False

Esta propiedad corresponde al parámetro del mismo nombre para la AWS CloudFormation CreateChangeSet API.

semanticVersion

cadena

False

La versión semántica de la aplicación:

https://semver.org/

stackName

cadena

True

Esta propiedad corresponde al parámetro del mismo nombre para la CloudFormation CreateChangeSet API.

tags

Matriz de tipo Tag

False

Esta propiedad corresponde al parámetro del mismo nombre para la AWS CloudFormation CreateChangeSet API.

templateId

cadena

False

El UUID devuelto por CreateCloudFormationTemplate.

Patrón: [0-9a-fA-F] {8}\ - [0-9a-fA-F] {4}\ - [0-9a-f] {4}\ - [0-9a-fA-F] {4}\ - [A-F0-9a-f] {12} A-F

ForbiddenException

El cliente no está autenticado.

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

403

message

cadena

False

El cliente no está autenticado.

InternalServerErrorException

El AWS Serverless Application Repository servicio detectó un error interno.

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

500

message

cadena

False

El AWS Serverless Application Repository servicio detectó un error interno.

ParameterValue

Valor del parámetro de la aplicación.

PropiedadTipoObligatorioDescripción
name

cadena

True

La clave asociada con el parámetro. Si no especificas una clave y un valor para un parámetro en particular, CloudFormation usa el valor predeterminado que se especifica en la plantilla.

value

cadena

True

El valor de entrada asociado con el parámetro.

RollbackConfiguration

Esta propiedad corresponde al tipo CloudFormation RollbackConfiguration de datos.

PropiedadTipoObligatorioDescription (Descripción)
monitoringTimeInMinutes

entero

False

Esta propiedad corresponde al contenido del mismo nombre para el tipo AWS CloudFormation RollbackConfiguration de datos.

rollbackTriggers

Matriz de tipo RollbackTrigger

False

Esta propiedad corresponde al contenido del mismo nombre para el tipo AWS CloudFormation RollbackConfiguration de datos.

RollbackTrigger

Esta propiedad corresponde al tipo CloudFormation RollbackTrigger de datos.

PropiedadTipoObligatorioDescripción
arn

cadena

True

Esta propiedad corresponde al contenido del mismo nombre para el tipo AWS CloudFormation RollbackTrigger de datos.

type

cadena

True

Esta propiedad corresponde al contenido del mismo nombre para el tipo AWS CloudFormation RollbackTrigger de datos.

Tag

Esta propiedad corresponde al tipo de datos de la CloudFormation etiqueta.

PropiedadTipoObligatorioDescripción
key

cadena

True

Esta propiedad corresponde al contenido del mismo nombre para el tipo de datos de AWS CloudFormation etiqueta.

value

cadena

True

Esta propiedad corresponde al contenido del mismo nombre para el tipo de datos de AWS CloudFormation etiqueta.

TooManyRequestsException

El cliente envía más solicitudes del permitido por unidad de tiempo.

PropiedadTipoObligatorioDescripción
errorCode

cadena

False

429

message

cadena

False

El cliente envía más solicitudes del permitido por unidad de tiempo.

Véase también

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

CreateCloudFormationChangeSet