applicationId Changesets für Anwendungen - AWS Serverless Application Repository
URIHTTPMethodenSchemataEigenschaftenWeitere Informationen finden Sie auch unter

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

applicationId Changesets für Anwendungen

URI

/applications/applicationId/changesets

HTTPMethoden

POST

Vorgangs-ID: CreateCloudFormationChangeSet

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

Pfadparameter
NameTypErforderlichBeschreibung
applicationIdStringTrue

Der Amazon-Ressourcenname (ARN) der Anwendung.

Antworten
StatuscodeAntwortmodellBeschreibung
201ChangeSetDetails

Herzlichen Glückwunsch

400BadRequestException

Einer der Parameter der Anfrage ist ungültig.

403ForbiddenException

Der Client ist nicht authentifiziert.

429TooManyRequestsException

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

500InternalServerErrorException

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

OPTIONS

Pfadparameter
NameTypErforderlichBeschreibung
applicationIdStringTrue

Der Amazon-Ressourcenname (ARN) der Anwendung.

Antworten
StatuscodeAntwortmodellBeschreibung
200None

Antwort 200

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.

EigenschaftTypErforderlichBeschreibung
errorCode

Zeichenfolge

False

400

message

Zeichenfolge

False

Einer der Parameter der Anfrage ist ungültig.

ChangeSetDetails

Einzelheiten des Änderungssatzes.

EigenschaftTypErforderlichBeschreibung
applicationId

Zeichenfolge

True

Die Anwendung Amazon Resource Name (ARN).

changeSetId

Zeichenfolge

True

Der Amazon-Ressourcenname (ARN) des Änderungssatzes.

Längenbeschränkungen: Minimale Länge von 1.

Muster:ARN: [-a-Za-Z0-9:/] *

semanticVersion

Zeichenfolge

True

Die semantische Version der Anwendung:

https://semver.org/

stackId

Zeichenfolge

True

Die eindeutige ID des Stacks.

CreateCloudFormationChangeSetInput

Erstellen Sie eine Anfrage für ein Anwendungs-Änderungssatz.

EigenschaftTypErforderlichBeschreibung
capabilities

Array des Typs string

False

Eine Liste von Werten, die Sie angeben müssen, bevor Sie bestimmte Anwendungen bereitstellen können. Einige Anwendungen können Ressourcen enthalten, die sich auf die Berechtigungen in Ihrem AWS Konto auswirken können, z. B. indem neue Benutzer AWS Identity and Access Management (IAM) erstellt werden. Für diese Anwendungen müssen Sie ihre Funktionen ausdrücklich bestätigen, indem Sie diesen Parameter angeben.

Die einzig gültigen Werte sind CAPABILITY_IAMCAPABILITY_NAMED_IAM,CAPABILITY_RESOURCE_POLICY, undCAPABILITY_AUTO_EXPAND.

Für die folgenden Ressourcen müssen Sie CAPABILITY_IAM oderCAPABILITY_NAMED_IAM:: AWS: :Group,IAM:: AWS:::,InstanceProfile,IAM:AWS:, Policy undIAM::: AWS:Role angeben. IAM Wenn die Anwendung IAM Ressourcen enthält, können Sie entweder oder angeben. CAPABILITY_IAM CAPABILITY_NAMED_IAM Wenn die Anwendung IAM Ressourcen mit benutzerdefinierten Namen enthält, müssen Sie Folgendes angebenCAPABILITY_NAMED_IAM.

Für die folgenden Ressourcen müssen SieCAPABILITY_RESOURCE_POLICY:: :LambdaAWS: :Permission,: ::Policy,AWS:::::IAM, AWS::ApplicationAutoScaling:,ScalingPolicy:::AWS,::, undBucketPolicy: AWS:SQS: angeben. QueuePolicy AWS 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 verbundenen 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

False

Diese Eigenschaft entspricht dem gleichnamigen Parameter für AWS CloudFormation CreateChangeSetAPI.

clientToken

Zeichenfolge

False

Diese Eigenschaft entspricht dem gleichnamigen Parameter für AWS CloudFormation CreateChangeSetAPI.

description

Zeichenfolge

False

Diese Eigenschaft entspricht dem gleichnamigen Parameter für AWS CloudFormation CreateChangeSetAPI.

notificationArns

Array des Typs string

False

Diese Eigenschaft entspricht dem gleichnamigen Parameter für AWS CloudFormation CreateChangeSetAPI.

parameterOverrides

Array des Typs ParameterValue

False

Eine Liste von Parameterwerten für die Parameter der Anwendung.

resourceTypes

Array des Typs string

False

Diese Eigenschaft entspricht dem gleichnamigen Parameter für AWS CloudFormation CreateChangeSetAPI.

rollbackConfiguration

RollbackConfiguration

False

Diese Eigenschaft entspricht dem gleichnamigen Parameter für AWS CloudFormation CreateChangeSetAPI.

semanticVersion

Zeichenfolge

False

Die semantische Version der Anwendung:

https://semver.org/

stackName

Zeichenfolge

True

Diese Eigenschaft entspricht dem gleichnamigen Parameter für AWS CloudFormation CreateChangeSetAPI.

tags

Array des Typs Markierung

False

Diese Eigenschaft entspricht dem gleichnamigen Parameter für AWS CloudFormation CreateChangeSetAPI.

templateId

Zeichenfolge

False

Der UUID zurückgegebene von CreateCloudFormationTemplate.

Muster: [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

Der Client ist nicht authentifiziert.

EigenschaftTypErforderlichBeschreibung
errorCode

Zeichenfolge

False

403

message

Zeichenfolge

False

Der Client ist nicht authentifiziert.

InternalServerErrorException

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

EigenschaftTypErforderlichBeschreibung
errorCode

Zeichenfolge

False

500

message

Zeichenfolge

False

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

ParameterValue

Parameterwert der Anwendung.

EigenschaftTypErforderlichBeschreibung
name

Zeichenfolge

True

Der Schlüssel, der dem Parameter zugeordnet ist. Wenn Sie keinen Schlüssel und keinen Wert für einen bestimmten Parameter angeben, wird der Standardwert AWS CloudFormation verwendet, der in Ihrer Vorlage angegeben ist.

value

Zeichenfolge

True

Der dem Parameter zugeordnete Eingabewert.

RollbackConfiguration

Diese Eigenschaft entspricht dem AWS CloudFormation RollbackConfigurationDatentyp.

EigenschaftTypErforderlichBeschreibung
monitoringTimeInMinutes

Ganzzahl

False

Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation RollbackConfigurationDatentyp.

rollbackTriggers

Array des Typs RollbackTrigger

False

Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation RollbackConfigurationDatentyp.

RollbackTrigger

Diese Eigenschaft entspricht dem AWS CloudFormation RollbackTriggerDatentyp.

EigenschaftTypErforderlichBeschreibung
arn

Zeichenfolge

True

Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation RollbackTriggerDatentyp.

type

Zeichenfolge

True

Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation RollbackTriggerDatentyp.

Tag

Diese Eigenschaft entspricht dem AWS CloudFormation Tag-Datentyp.

EigenschaftTypErforderlichBeschreibung
key

Zeichenfolge

True

Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation Tag-Datentyp.

value

Zeichenfolge

True

Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den AWS CloudFormation Tag-Datentyp.

TooManyRequestsException

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

EigenschaftTypErforderlichBeschreibung
errorCode

Zeichenfolge

False

429

message

Zeichenfolge

False

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

Weitere Informationen finden Sie auch unter

Weitere Informationen dazu, wie Sie dies API in einer der sprachspezifischen Sprachen AWS SDKs verwenden können, finden Sie in den folgenden Quellenangaben:

CreateCloudFormationChangeSet