Conjuntos de alterações do applicationId de aplicativos - AWS Serverless Application Repository

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

Conjuntos de alterações do applicationId de aplicativos

URI

/applications/applicationId/changesets

Métodos HTTP

POST

ID da operação:CreateCloudFormationChangeSet

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

Parâmetros de caminho
Name (Nome)TypeObrigatórioDescrição
applicationIdStringTrue

O nome de recurso da Amazon (ARN) do aplicativo.

Respostas
Código de statusModelo de respostaDescrição
201ChangeSetDetails

Bem-sucedida

400BadRequestException

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

403ForbiddenException

O cliente não está autenticado.

429TooManyRequestsException

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

500InternalServerErrorException

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

Esquemas

Os órgãos da solicitação

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

Response bodies

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

Propriedades

BadRequestException

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

PropriedadeTypeObrigatórioDescrição
errorCode

string

False

400

mensagem

string

False

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

ChangeSetDetails

Detalhes do conjunto de alterações.

PropriedadeTypeObrigatórioDescrição
applicationId

string

True

O nome de recurso da Amazon (ARN) do aplicativo do .

changeSetId

string

True

O nome de recurso da Amazon (ARN) do conjunto de alterações.

Restrições de tamanho: tamanho mínimo de 1.

Padrão: ARN: [-a-a-ZA-ZA-ZA-ZA-ZA-ZA-ZA-ZA-ZA-ZA-ZA-ZA-Z

Versão semântica

string

True

A versão semântica da aplicação:

https://semver.org/

ID da pilha

string

True

O ID exclusivo da pilha.

CreateCloudFormationChangeSetInput

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

PropriedadeTypeObrigatórioDescrição
capacidades

Matriz de tipostring

False

Uma lista de valores que você especificar antes que você especificar certos aplicativos. Alguns aplicativos podem incluir recursos que podem afetar permissões naAWS conta, por exemplo, criando novos usuários doAWS Identity and Access Management (IAM). Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro.

Os únicos valores válidos sãoCAPABILITY_IAMCAPABILITY_NAMED_IAMCAPABILITY_RESOURCE_POLICY,,CAPABILITY_AUTO_EXPAND e.

Os recursos a seguir exigem que você especifiqueCAPABILITY_IAM ouCAPABILITY_NAMED_IAM: AWS::IAM::GroupAWS::IAM::InstanceProfileAWS::IAM::Policy,, AWS::IAM::Rolee. Se o aplicativo contiver recursos do IAM, você especificar uma dessasCAPABILITY_IAM capacidadesCAPABILITY_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ê especifiqueCAPABILITY_RESOURCE_POLICY: AWS::Lambda::Permission, AWS: :iam:Policy AWS::ApplicationAutoScaling::ScalingPolicyAWS::S3::BucketPolicy, AWS::SQS::QueuePolicy,, e AWS: :SNS:TopicPolicy.

Os 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

False

Essa propriedade corresponde ao parâmetro com o mesmo nome da AWS CloudFormationCreateChangeSetAPI.

clientToken

string

False

Essa propriedade corresponde ao parâmetro com o mesmo nome da AWS CloudFormationCreateChangeSetAPI.

descrição

string

False

Essa propriedade corresponde ao parâmetro com o mesmo nome da AWS CloudFormationCreateChangeSetAPI.

ARNs de notificação

Matriz de tipostring

False

Essa propriedade corresponde ao parâmetro com o mesmo nome da AWS CloudFormationCreateChangeSetAPI.

Sobreposições de parâmetros

Matriz de tipoParameterValue

False

Uma lista de valores de parâmetros para os parâmetros da aplicação.

resourceTypes

Matriz de tipostring

False

Essa propriedade corresponde ao parâmetro com o mesmo nome da AWS CloudFormationCreateChangeSetAPI.

Configuração de reversão

RollbackConfiguration

False

Essa propriedade corresponde ao parâmetro com o mesmo nome da AWS CloudFormationCreateChangeSetAPI.

Versão semântica

string

False

A versão semântica da aplicação:

https://semver.org/

Nome da pilha

string

True

Essa propriedade corresponde ao parâmetro com o mesmo nome da AWS CloudFormationCreateChangeSetAPI.

tags

Matriz de tipoTag

False

Essa propriedade corresponde ao parâmetro com o mesmo nome da AWS CloudFormationCreateChangeSetAPI.

ID do modelo

string

False

O UUID retornado por CreateCloudFormationTemplate.

Padrão: [0-9a-fa-F] {8}\ - [0-9a-fa-F] {4}\ - [0-9a-fa-F] {4}\ - [0-9a-fa-F] {4}\ - [0-9a-fa-F] {12}

ForbiddenException

O cliente não está autenticado.

PropriedadeTypeObrigatórioDescrição
errorCode

string

False

403

mensagem

string

False

O cliente não está autenticado.

InternalServerErrorException

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

PropriedadeTypeObrigatórioDescrição
errorCode

string

False

500

mensagem

string

False

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

ParameterValue

O valor do parâmetro do aplicativo.

PropriedadeTypeObrigatórioDescrição
name

string

True

A chave associada ao parâmetro. Se você não especificar uma chave e um valor para um parâmetro específico, oAWS CloudFormation usará o valor padrão especificado no modelo.

value

string

True

O valor de entrada associado ao parâmetro.

RollbackConfiguration

Essa propriedade corresponde ao Tipo AWS CloudFormationRollbackConfigurationde dados.

PropriedadeTypeObrigatórioDescrição
monitoringTimeInMinutos

integer

False

Essa propriedade corresponde ao conteúdo com o mesmo nome para o Tipo de AWS CloudFormationRollbackConfigurationDados.

Acionadores de reversão

Matriz de tipoRollbackTrigger

False

Essa propriedade corresponde ao conteúdo com o mesmo nome para o Tipo de AWS CloudFormationRollbackConfigurationDados.

RollbackTrigger

Essa propriedade corresponde ao Tipo AWS CloudFormationRollbackTriggerde dados.

PropriedadeTypeObrigatórioDescrição
arn

string

True

Essa propriedade corresponde ao conteúdo com o mesmo nome para o Tipo de AWS CloudFormationRollbackTriggerDados.

type

string

True

Essa propriedade corresponde ao conteúdo com o mesmo nome para o Tipo de AWS CloudFormationRollbackTriggerDados.

Tag

Essa propriedade corresponde ao tipo de dados da AWS CloudFormationtag.

PropriedadeTypeObrigatórioDescrição
chave

string

True

Essa propriedade corresponde ao conteúdo com o mesmo nome do Tipo de Dados da AWS CloudFormationTag.

value

string

True

Essa propriedade corresponde ao conteúdo com o mesmo nome do Tipo de Dados da AWS CloudFormationTag.

TooManyRequestsException

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

PropriedadeTypeObrigatórioDescrição
errorCode

string

False

429

mensagem

string

False

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

Consulte também

Para obter mais informações sobre como usar essa API em um dosAWS SDKs específicos de linguagem, consulte o seguinte:

CreateCloudFormationChangeSet