URI Métodos HTTP Esquemas Propriedades Consulte também

Conjuntos de alterações de IDs de aplicativos

URI

/applications/applicationId/changesets

Métodos HTTP

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

Respostas
Código de status	Modelo de resposta	Description
`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`	String	Verdadeiro	O nome de recurso da Amazon (ARN) do aplicativo.

Respostas
Código de status	Modelo de resposta	Description
`200`	Nenhum	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.

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 (ARN) do aplicativo do .
`changeSetId`	string	Verdadeiro	O nome de recurso da Amazon (ARN) do conjunto de alterações. Restrições de tamanho: tamanho mínimo 1. Padrão: ARN: [-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	Description
`capabilities`	Matriz do tipo string	Falso	Uma lista de valores que você deve especificar antes de implantar determinados aplicativos. Alguns aplicativos podem incluir recursos que podem afetar as permissões em sua AWS conta, por exemplo, criando novos 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 seguintes recursos exigem que você especifique `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`: AWS: :IAM: :Group, AWS: :IAM::, AWS: :IAM: InstanceProfile :Policy e AWS: :IAM: :Role. Se o aplicativo contiver recursos do IAM, você poderá especificar `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`. Se o aplicativo contém recursos do IAM com nomes personalizados, você deverá especificar `CAPABILITY_NAMED_IAM`. Os seguintes recursos exigem que você especifique`CAPABILITY_RESOURCE_POLICY`: AWS::Lambda: :Permission, AWS:: IAM:Policy, AWS::ApplicationAutoScaling:: ScalingPolicy, AWS: :S3:: BucketPolicy, AWS: :SQS:: e AWS:: QueuePolicy. SNS:TopicPolicy Os aplicativos que contêm um ou mais aplicativos aninhados exigem que você especifique `CAPABILITY_AUTO_EXPAND`. Se o modelo do seu 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 exige recursos, a chamada falhará.
`changeSetName`	string	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para a AWS CloudFormation CreateChangeSet API.
`clientToken`	string	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para a AWS CloudFormation CreateChangeSet API.
`description`	string	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para a AWS CloudFormation CreateChangeSet API.
`notificationArns`	Matriz do tipo string	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para a AWS CloudFormation CreateChangeSet API.
`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 a AWS CloudFormation CreateChangeSet API.
`rollbackConfiguration`	RollbackConfiguration	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para a 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 a CloudFormation CreateChangeSet API.
`tags`	Matriz do tipo Tag	Falso	Essa propriedade corresponde ao parâmetro de mesmo nome para a 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-f] {4}\ - [0-9a-fA-F] {4}\ - [0-9a-fA-F] {12} A-F

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, CloudFormation use 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 CloudFormation RollbackConfiguration de dados.

Propriedade	Tipo	Obrigatório	Description
`monitoringTimeInMinutes`	integer	Falso	Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de AWS CloudFormation RollbackConfiguration Dados.
`rollbackTriggers`	Matriz do tipo RollbackTrigger	Falso	Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de AWS CloudFormation RollbackConfiguration Dados.

RollbackTrigger

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

Tag

Essa propriedade corresponde ao Tipo de dados da CloudFormation tag.

Propriedade	Tipo	Obrigatório	Descrição
`key`	string	Verdadeiro	Essa propriedade corresponde ao conteúdo de mesmo nome para o Tipo de dados da AWS CloudFormation tag.
`value`	string	Verdadeiro	Essa propriedade corresponde ao conteúdo de 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 essa API em um dos AWS SDKs e referências específicos do idioma, consulte o seguinte:

CreateCloudFormationChangeSet

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

ID do aplicativo de aplicativos

Dependências do ApplicationID de aplicativos