Conjuntos de applicationId alterações de aplicativos

URI

/applications/applicationId/changesets

HTTPmétodos

POST

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	Cadeia de caracteres	Verdadeiro	O nome do recurso Amazon (ARN) do aplicativo.

Respostas
Código de status	Modelo de resposta	Descrição
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

Parâmetros de caminho
Nome	Tipo	Obrigatório	Descrição
applicationId	Cadeia de caracteres	Verdadeiro	O nome do recurso Amazon (ARN) do aplicativo.

Respostas
Código de status	Modelo de resposta	Descrição
200	Nenhum	200 respostas

Esquemas

Corpos da solicitação

Esquema POST

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

Esquema ChangeSetDetails

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

Esquema BadRequestException

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

Esquema ForbiddenException

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

Esquema TooManyRequestsException

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

Esquema InternalServerErrorException

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

Propriedades

BadRequestException

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

Detalhes do conjunto de alterações.

Propriedade	Tipo	Obrigatório	Descriçã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.

Propriedade	Tipo	Obrigatório	Descrição
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_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 AWS CloudFormation CreateChangeSetAPIo.
clientToken	string	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para AWS CloudFormation CreateChangeSetAPIo.
description	string	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para AWS CloudFormation CreateChangeSetAPIo.
notificationArns	Matriz do tipo string	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para AWS CloudFormation CreateChangeSetAPIo.
parameterOverrides	Matriz do tipo 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 de mesmo nome para AWS CloudFormation CreateChangeSetAPIo.
rollbackConfiguration	RollbackConfiguration	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para AWS CloudFormation CreateChangeSetAPIo.
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 AWS CloudFormation CreateChangeSetAPIo.
tags	Matriz do tipo Tag	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para AWS CloudFormation CreateChangeSetAPIo.
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.

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

InternalServerErrorException

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

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, AWS CloudFormation usa o valor padrão especificado no seu modelo.
value	string	Verdadeiro	O valor de entrada associado ao parâmetro.

RollbackConfiguration

Essa propriedade corresponde ao Tipo AWS CloudFormation RollbackConfigurationde dados.

Propriedade	Tipo	Obrigatório	Descrição
monitoringTimeInMinutes	inteiro	Falso	Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de AWS CloudFormation RollbackConfigurationdados.
rollbackTriggers	Matriz do tipo RollbackTrigger	Falso	Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de AWS CloudFormation RollbackConfigurationdados.

RollbackTrigger

Essa propriedade corresponde ao Tipo AWS CloudFormation RollbackTriggerde 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 RollbackTriggerdados.
type	string	Verdadeiro	Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de AWS CloudFormation RollbackTriggerdados.

Tag

Essa propriedade corresponde ao Tipo de Dados da AWS CloudFormation 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.
value	string	Verdadeiro	Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de Dados da AWS CloudFormation Tag.

TooManyRequestsException

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

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

CreateCloudFormationChangeSet

• AWS Interface da linha de comando

• AWSSDKpara. NET

• AWSSDKpara C++

• AWSSDKpara Go v2

• AWSSDKpara Java V2

• AWSSDKpara JavaScript V3

• AWSSDKpara PHP V3

• AWSSDKpara Python

• AWSSDKpara Ruby V3