Conjuntos de applicationId alterações 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 applicationId alterações de aplicativos

URI

/applications/applicationId/changesets

HTTPmétodos

POST

ID da operação: CreateCloudFormationChangeSet

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

Parâmetros de caminho
NomeTipoObrigatórioDescrição
applicationIdCadeia de caracteresVerdadeiro

O nome do recurso 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

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

OPTIONS

Parâmetros de caminho
NomeTipoObrigatórioDescrição
applicationIdCadeia de caracteresVerdadeiro

O nome do recurso Amazon (ARN) do aplicativo.

Respostas
Código de statusModelo de respostaDescrição
200Nenhum

200 respostas

Esquemas

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

Corpos da resposta

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

PropriedadeTipoObrigatórioDescrição
errorCode

string

Falso

400

message

string

Falso

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

ChangeSetDetails

Detalhes do conjunto de alterações.

PropriedadeTipoObrigatórioDescrição
applicationId

string

Verdadeiro

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

changeSetId

string

Verdadeiro

O Amazon Resource Name (ARN) do conjunto de alterações.

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

PadrãoARN: [-a-zA-z0-9:/] *

semanticVersion

string

Verdadeiro

A versão semântica do aplicativo:

https://semver.org/

stackId

string

Verdadeiro

O ID exclusivo da pilha.

CreateCloudFormationChangeSetInput

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

PropriedadeTipoObrigatórioDescrição
capabilities

Matriz de tipos 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 seu AWS conta, por exemplo, criando uma nova AWS Identity and Access Management (IAM) usuários. Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro.

Os únicos valores válidos são CAPABILITY_IAM CAPABILITY_NAMED_IAMCAPABILITY_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 :Policy eIAM:: AWSIAM: :Role. AWS Se o aplicativo contiver IAM recursos, você poderá especificar CAPABILITY_IAM ouCAPABILITY_NAMED_IAM. Se o aplicativo contiver IAM recursos com nomes personalizados, você deverá especificarCAPABILITY_NAMED_IAM.

Os recursos a seguir exigem que você especifiqueCAPABILITY_RESOURCE_POLICY: AWS: :Lambda: :Permission, AWS: ::PolicyIAM,:: AWS::ApplicationAutoScaling:,ScalingPolicy: AWSS3::,:::: eBucketPolicy: AWS: SQS. QueuePolicy 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

Falso

Essa propriedade corresponde ao parâmetro de mesmo nome para o AWS CloudFormation CreateChangeSet API.

clientToken

string

Falso

Essa propriedade corresponde ao parâmetro de mesmo nome para o AWS CloudFormation CreateChangeSet API.

description

string

Falso

Essa propriedade corresponde ao parâmetro de mesmo nome para o AWS CloudFormation CreateChangeSet API.

notificationArns

Matriz de tipos string

Falso

Essa propriedade corresponde ao parâmetro de mesmo nome para o AWS CloudFormation CreateChangeSet API.

parameterOverrides

Matriz de tipos ParameterValue

Falso

Uma lista de valores de parâmetros para os parâmetros do aplicativo.

resourceTypes

Matriz de tipos string

Falso

Essa propriedade corresponde ao parâmetro de mesmo nome para o AWS CloudFormation CreateChangeSet API.

rollbackConfiguration

RollbackConfiguration

Falso

Essa propriedade corresponde ao parâmetro de mesmo nome para o AWS CloudFormation CreateChangeSet API.

semanticVersion

string

Falso

A versão semântica do aplicativo:

https://semver.org/

stackName

string

Verdadeiro

Essa propriedade corresponde ao parâmetro de mesmo nome para o AWS CloudFormation CreateChangeSet API.

tags

Matriz de tipos Tag

Falso

Essa propriedade corresponde ao parâmetro de mesmo nome para o AWS CloudFormation CreateChangeSet API.

templateId

string

Falso

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.

PropriedadeTipoObrigatórioDescrição
errorCode

string

Falso

403

message

string

Falso

O cliente não está autenticado.

InternalServerErrorException

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

PropriedadeTipoObrigatórioDescrição
errorCode

string

Falso

500

message

string

Falso

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

ParameterValue

Valor do parâmetro do aplicativo.

PropriedadeTipoObrigatórioDescriçã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, AWS CloudFormation usa o valor padrão especificado no seu modelo.

value

string

Verdadeiro

O valor de entrada associado ao parâmetro.

RollbackConfiguration

Esta propriedade corresponde ao AWS CloudFormation RollbackConfigurationTipo de dados.

PropriedadeTipoObrigatórioDescrição
monitoringTimeInMinutes

inteiro

Falso

Essa propriedade corresponde ao conteúdo do mesmo nome para o AWS CloudFormation RollbackConfigurationTipo de dados.

rollbackTriggers

Matriz de tipos RollbackTrigger

Falso

Essa propriedade corresponde ao conteúdo do mesmo nome para o AWS CloudFormation RollbackConfigurationTipo de dados.

RollbackTrigger

Esta propriedade corresponde ao AWS CloudFormation RollbackTriggerTipo de dados.

PropriedadeTipoObrigatórioDescrição
arn

string

Verdadeiro

Essa propriedade corresponde ao conteúdo do mesmo nome para o AWS CloudFormation RollbackTriggerTipo de dados.

type

string

Verdadeiro

Essa propriedade corresponde ao conteúdo do mesmo nome para o AWS CloudFormation RollbackTriggerTipo de dados.

Tag

Esta propriedade corresponde ao AWS CloudFormation Tipo de dados da tag.

PropriedadeTipoObrigatórioDescrição
key

string

Verdadeiro

Essa propriedade corresponde ao conteúdo do mesmo nome para o AWS CloudFormation Tipo de dados da tag.

value

string

Verdadeiro

Essa propriedade corresponde ao conteúdo do mesmo nome para o AWS CloudFormation Tipo de dados da tag.

TooManyRequestsException

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

PropriedadeTipoObrigatórioDescriçã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

Para obter mais informações sobre como usar isso API em um dos idiomas específicos AWS SDKse referências, veja o seguinte:

CreateCloudFormationChangeSet