URI Méthodes HTTP Schémas Propriétés Consultez aussi

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


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


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


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


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


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


{
  "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`, et`CAPABILITY_AUTO_EXPAND`. Les ressources suivantes nécessitent que vous spécifiiez `CAPABILITY_IAM` ou `CAPABILITY_NAMED_IAM` : AWS::IAM::Group AWS::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` soit`CAPABILITY_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::ScalingPolicy AWS::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

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Applications (ApplicationID)

Applications applicationId Dependencies