Applications ApplicationID : ensembles de modifications

URI

/applications/applicationId/changesets

Méthodes HTTP

POST

ID de l'opération : CreateCloudFormationChangeSet

Crée un ensemble de AWS CloudFormation modifications pour l'application donnée.

Paramètres de chemin d'accès

Nom	Type	Obligatoire	Description
applicationId	Chaîne	True	Amazon Resource Name (ARN) de l'application.

Réponses

Code de statut	Modèle de réponse	Description
201	ChangeSetDetails	Réussite
400	BadRequestException	L'un des paramètres dans la demande n'est pas valide.
403	ForbiddenException	Le client n'est pas authentifié.
429	TooManyRequestsException	Le client envoie plus longtemps que le nombre de demandes autorisé.
500	InternalServerErrorException	Le AWS Serverless Application Repository service a rencontré une erreur interne.

OPTIONS

Paramètres de chemin d'accès

Nom	Type	Obligatoire	Description
applicationId	Chaîne	True	Amazon Resource Name (ARN) de l'application.

Réponses

Code de statut	Modèle de réponse	Description
200	Aucun	Réponse 200

Schémas

Corps de la demande

Schéma 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"
    }
  ]
}

Corps de la réponse

Schéma ChangeSetDetails

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

Schéma BadRequestException

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

Schéma ForbiddenException

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

Schéma TooManyRequestsException

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

Schéma InternalServerErrorException

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

Propriétés

BadRequestException

L'un des paramètres dans la demande n'est pas valide.

Propriété	Type	Obligatoire	Description
errorCode	chaîne	False	400
message	chaîne	False	L'un des paramètres dans la demande n'est pas valide.

ChangeSetDetails

Détails de l'ensemble de modification.

Propriété	Type	Obligatoire	Description
applicationId	chaîne	True	Amazon Resource Name (ARN) de l'application .
changeSetId	chaîne	True	Amazon Resource Name (ARN) du jeu de modifications. Contraintes de longueur : longueur minimale de 1. Modèle : ARN : [a-Za-Z0-9 :/] *
semanticVersion	chaîne	True	Version sémantique de l'application : https://semver.org/
stackId	chaîne	True	ID unique de la pile.

CreateCloudFormationChangeSetInput

Créez une demande d'ensemble de modifications d'application.

Propriété	Type	Obligatoire	Description
capabilities	Tableau de type string	False	Une liste de valeurs que vous devez spécifier avant de pouvoir déployer certaines applications. Certaines applications peuvent comporter des ressources susceptibles d'affecter des autorisations dans votre AWS compte, par exemple, en créant des utilisateurs AWS Identity and Access Management (IAM). Pour ces applications, vous devez explicitement reconnaître leurs capacités en spécifiant ce paramètre. Les seules valeurs valides sont CAPABILITY_IAMCAPABILITY_NAMED_IAM,CAPABILITY_RESOURCE_POLICY, etCAPABILITY_AUTO_EXPAND. Les ressources suivantes nécessitent que vous spécifiiez CAPABILITY_IAM ou CAPABILITY_NAMED_IAM : AWS::IAM::GroupAWS::IAM::InstanceProfile, AWS::IAM::Policy, et AWS::IAM::Role. Si l'application contient des ressources IAM, vous pouvez spécifier l'une ou l'autre de ces ressources, vous pouvez spécifier CAPABILITY_IAM soitCAPABILITY_NAMED_IAM. Si l'application contient des ressources IAM dotées de noms personnalisés, vous devez spécifier CAPABILITY_NAMED_IAM. Les ressources suivantes nécessitent que vous spécifiez CAPABILITY_RESOURCE_POLICY : AWS::Lambda::Permission, AWS : :IAM:Policy,,, AWS::ApplicationAutoScaling::ScalingPolicyAWS::S3::BucketPolicy, AWS::SQS::QueuePolicyet AWS : :SNS :. TopicPolicy Les applications contenant une ou plusieurs applications imbriquées exigent de spécifier CAPABILITY_AUTO_EXPAND. Si votre modèle d'application contient l'une des ressources ci-dessus, nous vous recommandons de vérifier toutes les autorisations associées à l'application avant le déploiement. Si vous ne spécifiez pas ce paramètre pour une application qui nécessite des fonctionnalités, l'appel échouera.
changeSetName	chaîne	False	Cette propriété correspond au paramètre du même nom pour l'AWS CloudFormation CreateChangeSetAPI.
clientToken	chaîne	False	Cette propriété correspond au paramètre du même nom pour l'AWS CloudFormation CreateChangeSetAPI.
description	chaîne	False	Cette propriété correspond au paramètre du même nom pour l'AWS CloudFormation CreateChangeSetAPI.
notificationArns	Tableau de type string	False	Cette propriété correspond au paramètre du même nom pour l'AWS CloudFormation CreateChangeSetAPI.
parameterOverrides	Tableau de type ParameterValue	False	Liste de valeurs de paramètres de l'application.
resourceTypes	Tableau de type string	False	Cette propriété correspond au paramètre du même nom pour l'AWS CloudFormation CreateChangeSetAPI.
rollbackConfiguration	RollbackConfiguration	False	Cette propriété correspond au paramètre du même nom pour l'AWS CloudFormation CreateChangeSetAPI.
semanticVersion	chaîne	False	Version sémantique de l'application : https://semver.org/
stackName	chaîne	True	Cette propriété correspond au paramètre du même nom pour l'AWS CloudFormation CreateChangeSetAPI.
tags	Tableau de type Tag	False	Cette propriété correspond au paramètre du même nom pour l'AWS CloudFormation CreateChangeSetAPI.
templateId	chaîne	False	L'UUID renvoyé par. CreateCloudFormationTemplate Schéma : [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

Le client n'est pas authentifié.

Propriété	Type	Obligatoire	Description
errorCode	chaîne	False	403
message	chaîne	False	Le client n'est pas authentifié.

InternalServerErrorException

Le AWS Serverless Application Repository service a rencontré une erreur interne.

Propriété	Type	Obligatoire	Description
errorCode	chaîne	False	500
message	chaîne	False	Le AWS Serverless Application Repository service a rencontré une erreur interne.

ParameterValue

Valeur du paramètre de l'application.

Propriété	Type	Obligatoire	Description
name	chaîne	True	Clé associée au paramètre. Si vous ne spécifiez pas de clé et de valeur pour un paramètre particulier, AWS CloudFormation utilise la valeur par défaut spécifiée dans votre modèle.
value	chaîne	True	Valeur d'entrée associée au paramètre.

RollbackConfiguration

Cette propriété correspond au type AWS CloudFormation RollbackConfigurationde données.

Propriété	Type	Obligatoire	Description
monitoringTimeInMinutes	integer	False	Cette propriété correspond au contenu du même nom pour le type de AWS CloudFormation RollbackConfigurationdonnées.
rollbackTriggers	Tableau de type RollbackTrigger	False	Cette propriété correspond au contenu du même nom pour le type de AWS CloudFormation RollbackConfigurationdonnées.

RollbackTrigger

Cette propriété correspond au type AWS CloudFormation RollbackTriggerde données.

Propriété	Type	Obligatoire	Description
arn	chaîne	True	Cette propriété correspond au contenu du même nom pour le type de AWS CloudFormation RollbackTriggerdonnées.
type	chaîne	True	Cette propriété correspond au contenu du même nom pour le type de AWS CloudFormation RollbackTriggerdonnées.

Tag

Cette propriété correspond au type de données de AWS CloudFormation balise.

Propriété	Type	Obligatoire	Description
key	chaîne	True	Cette propriété correspond au contenu du même nom pour le type de données de AWS CloudFormation balise.
value	chaîne	True	Cette propriété correspond au contenu du même nom pour le type de données de AWS CloudFormation balise.

TooManyRequestsException

Le client envoie plus longtemps que le nombre de demandes autorisé.

Propriété	Type	Obligatoire	Description
errorCode	chaîne	False	429
message	chaîne	False	Le client envoie plus longtemps que le nombre de demandes autorisé.

Consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'une des ressources spécifiques au langage, consultez AWS SDKs les ressources suivantes :

CreateCloudFormationChangeSet

• interface ligne de commande AWS

• Kit AWS SDK pour .NET

• Kit AWS SDK pour C++

• SDK AWS pour Go v2

• Kit AWS SDK pour Java V2

• SDK AWS pour V3 JavaScript

• Kit SDK pour Kotlin

• AWS SDK pour PHP V3

• AWS SDK pour Python

• AWS SDK pour Ruby V3