URI HTTP-Methoden Schemata Eigenschaften Weitere Informationen finden Sie auch unter

Anwendungs-ID-Änderungssätze

URI

/applications/applicationId/changesets

HTTP-Methoden

POST

Vorgangs-ID: CreateCloudFormationChangeSet

Erstellt einen AWS CloudFormation Änderungssatz für die angegebene Anwendung.

Pfadparameter
Name	Typ	Erforderlich	Beschreibung
`applicationId`	Zeichenfolge	Wahr	Der Amazon-Ressourcenname (ARN) der Anwendung.

Antworten
Statuscode	Antwortmodell	Description
`201`	`ChangeSetDetails`	Herzlichen Glückwunsch
`400`	`BadRequestException`	Einer der Parameter der Anfrage ist ungültig.
`403`	`ForbiddenException`	Der Client ist nicht authentifiziert.
`429`	`TooManyRequestsException`	Der Client sendet mehr als die zulässige Anzahl von Anfragen pro Zeiteinheit.
`500`	`InternalServerErrorException`	Beim AWS Serverless Application Repository Dienst ist ein interner Fehler aufgetreten.

OPTIONS

Pfadparameter
Name	Typ	Erforderlich	Beschreibung
`applicationId`	Zeichenfolge	Wahr	Der Amazon-Ressourcenname (ARN) der Anwendung.

Antworten
Statuscode	Antwortmodell	Description
`200`	Keine	200 Antwort

Schemata

Anfragetexte


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

Antworttexte


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


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


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


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


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

Eigenschaften

BadRequestException

Einer der Parameter der Anfrage ist ungültig.

Eigenschaft	Typ	Erforderlich	Beschreibung
`errorCode`	Zeichenfolge	Falsch	400
`message`	Zeichenfolge	Falsch	Einer der Parameter der Anfrage ist ungültig.

ChangeSetDetails

Details des Änderungssatzes.

Eigenschaft	Typ	Erforderlich	Beschreibung
`applicationId`	Zeichenfolge	Wahr	Der Amazon-Ressourcenname (ARN) der -Anwendung
`changeSetId`	Zeichenfolge	Wahr	Der Amazon-Ressourcenname (ARN) des Änderungssatzes. Längenbeschränkungen: Minimale Länge von 1. Muster: ARN: [-a-zA-Z0-9:/] *
`semanticVersion`	Zeichenfolge	Wahr	Die semantische Version der Anwendung: https://semver.org/
`stackId`	Zeichenfolge	Wahr	Die eindeutige ID des Stacks.

CreateCloudFormationChangeSetInput

Erstellen Sie eine Anfrage für einen Anwendungsänderungssatz.

Eigenschaft	Typ	Erforderlich	Description
`capabilities`	Array vom Typ string	Falsch	Eine Liste von Werten, die Sie angeben müssen, bevor Sie bestimmte Anwendungen bereitstellen können. Einige Anwendungen enthalten möglicherweise Ressourcen, die sich auf die Berechtigungen in Ihrem AWS Konto auswirken können, z. B. durch das Erstellen neuer AWS Identity and Access Management (IAM) -Benutzer. Für diese Anwendungen müssen Sie deren Funktionen explizit bestätigen, indem Sie diesen Parameter angeben. Die einzig gültigen Werte sind `CAPABILITY_IAMCAPABILITY_NAMED_IAM`,`CAPABILITY_RESOURCE_POLICY`, und`CAPABILITY_AUTO_EXPAND`. Für die folgenden Ressourcen müssen Sie `CAPABILITY_IAM` oder angeben`CAPABILITY_NAMED_IAM`: AWS: :IAM: :Group, AWS: :IAM::, AWS: :IAM: InstanceProfile :Policy und AWS: :IAM: :Role. https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html Wenn die Anwendung IAM-Ressourcen enthält, können Sie entweder oder angeben. `CAPABILITY_IAM` `CAPABILITY_NAMED_IAM` Beinhaltet die Anwendung IAM-Ressourcen mit benutzerdefinierten Namen, müssen Sie `CAPABILITY_NAMED_IAM` angeben. Für die folgenden Ressourcen müssen Sie Folgendes angeben`CAPABILITY_RESOURCE_POLICY`: AWS::Lambda: :Permission, AWS:: IAM:Policy, AWS::ApplicationAutoScaling:: ScalingPolicy, AWS: :S3:: BucketPolicy, AWS: :SQS:: und AWS:: QueuePolicy. SNS:TopicPolicy Bei Anwendungen, die eine oder mehrere verschachtelte Anwendungen enthalten, müssen Sie `CAPABILITY_AUTO_EXPAND` angeben. Wenn Ihre Anwendungsvorlage eine der oben genannten Ressourcen enthält, empfehlen wir Ihnen, vor der Bereitstellung alle mit der Anwendung verknüpften Berechtigungen zu überprüfen. Wenn Sie diesen Parameter nicht für eine Anwendung angeben, die Funktionen benötigt, schlägt der Aufruf fehl.
`changeSetName`	Zeichenfolge	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Parameter für die AWS CloudFormation CreateChangeSet API.
`clientToken`	Zeichenfolge	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Parameter für die AWS CloudFormation CreateChangeSet API.
`description`	Zeichenfolge	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Parameter für die AWS CloudFormation CreateChangeSet API.
`notificationArns`	Array vom Typ string	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Parameter für die AWS CloudFormation CreateChangeSet API.
`parameterOverrides`	Array vom Typ ParameterValue	Falsch	Eine Liste von Parameterwerten für die Parameter der Anwendung.
`resourceTypes`	Array vom Typ string	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Parameter für die AWS CloudFormation CreateChangeSet API.
`rollbackConfiguration`	RollbackConfiguration	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Parameter für die AWS CloudFormation CreateChangeSet API.
`semanticVersion`	Zeichenfolge	Falsch	Die semantische Version der Anwendung: https://semver.org/
`stackName`	Zeichenfolge	Wahr	Diese Eigenschaft entspricht dem gleichnamigen Parameter für die CloudFormation CreateChangeSet API.
`tags`	Array vom Typ Tag	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Parameter für die AWS CloudFormation CreateChangeSet API.
`templateId`	Zeichenfolge	Falsch	Die von zurückgegebene UUID. CreateCloudFormationTemplate Muster: [0-9a-fA-F] {8}\ - [0-9a-f] {4}\ - [0-9a-fA-F] {4}\ - [0-9a-f] {4}\ - [0-9a-fA-F] {4}\ - [A-F0-9a-f] {12} A-F

ForbiddenException

Der Client ist nicht authentifiziert.

Eigenschaft	Typ	Erforderlich	Beschreibung
`errorCode`	Zeichenfolge	Falsch	403
`message`	Zeichenfolge	Falsch	Der Client ist nicht authentifiziert.

InternalServerErrorException

Beim AWS Serverless Application Repository Dienst ist ein interner Fehler aufgetreten.

Eigenschaft	Typ	Erforderlich	Beschreibung
`errorCode`	Zeichenfolge	Falsch	500
`message`	Zeichenfolge	Falsch	Beim AWS Serverless Application Repository Dienst ist ein interner Fehler aufgetreten.

ParameterValue

Parameterwert der Anwendung.

Eigenschaft	Typ	Erforderlich	Beschreibung
`name`	Zeichenfolge	Wahr	Der Schlüssel, der dem Parameter zugeordnet ist. Wenn Sie für einen bestimmten Parameter keinen Schlüssel und keinen Wert angeben, wird der in Ihrer Vorlage angegebene Standardwert CloudFormation verwendet.
`value`	Zeichenfolge	Wahr	Der dem Parameter zugeordnete Eingabewert.

RollbackConfiguration

Diese Eigenschaft entspricht dem CloudFormation RollbackConfiguration Datentyp.

Eigenschaft	Typ	Erforderlich	Description
`monitoringTimeInMinutes`	Ganzzahl	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation RollbackConfiguration Datentyp.
`rollbackTriggers`	Array vom Typ RollbackTrigger	Falsch	Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation RollbackConfiguration Datentyp.

RollbackTrigger

Diese Eigenschaft entspricht dem CloudFormation RollbackTrigger Datentyp.

Eigenschaft	Typ	Erforderlich	Beschreibung
`arn`	Zeichenfolge	Wahr	Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation RollbackTrigger Datentyp.
`type`	Zeichenfolge	Wahr	Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation RollbackTrigger Datentyp.

Markierung

Diese Eigenschaft entspricht dem CloudFormation https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag Tag-Datentyp.

Eigenschaft	Typ	Erforderlich	Beschreibung
`key`	Zeichenfolge	Wahr	Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag Tag-Datentyp.
`value`	Zeichenfolge	Wahr	Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag Tag-Datentyp.

TooManyRequestsException

Der Client sendet mehr als die zulässige Anzahl von Anfragen pro Zeiteinheit.

Eigenschaft	Typ	Erforderlich	Beschreibung
`errorCode`	Zeichenfolge	Falsch	429
`message`	Zeichenfolge	Falsch	Der Client sendet mehr als die zulässige Anzahl von Anfragen pro Zeiteinheit.

Weitere Informationen finden Sie auch unter

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs und Referenzen finden Sie im Folgenden:

CreateCloudFormationChangeSet

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Anwendungen (Anwendungs-ID)

Abhängigkeiten von Anwendungen (ApplicationID)