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. # Anwendungen ApplicationID-Versionen SemanticVersion ## URI `/applications/{{applicationId}}/versions/{{semanticVersion}}` ## HTTP-Methoden ### PUT **Vorgangs-ID:** `CreateApplicationVersion` Erstellt eine Anwendungsversion **Pfadparameter** | Name | Typ | Erforderlich | Beschreibung | | --- |--- |--- |--- | | {{applicationId}} | Zeichenfolge | Wahr | Der Amazon-Ressourcenname (ARN) der Anwendung. | | {{semanticVersion}} | Zeichenfolge | Wahr | Die semantische Version der neuen Version. | **Antworten** | Statuscode | Antwortmodell | Description | | --- |--- |--- | | 201 | Version | Herzlichen Glückwunsch | | 400 | BadRequestException | Einer der Parameter der Anfrage ist ungültig. | | 403 | ForbiddenException | Der Client ist nicht authentifiziert. | | 409 | ConflictException | Die Ressource ist bereits vorhanden. | | 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. | | {{semanticVersion}} | Zeichenfolge | Wahr | Die semantische Version der neuen Version. | **Antworten** | Statuscode | Antwortmodell | Description | | --- |--- |--- | | 200 | Keine | Antwort von 200 | ## Schemata ### Anfragetexte #### PUT-Schema ``` { "templateBody": "string", "templateUrl": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string" } ``` ### Antworttexte #### Version-Schema ``` { "applicationId": "string", "semanticVersion": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string", "templateUrl": "string", "creationTime": "string", "parameterDefinitions": [ { "name": "string", "defaultValue": "string", "description": "string", "type": "string", "noEcho": boolean, "allowedPattern": "string", "constraintDescription": "string", "minValue": integer, "maxValue": integer, "minLength": integer, "maxLength": integer, "allowedValues": [ "string" ], "referencedByResources": [ "string" ] } ], "requiredCapabilities": [ enum ], "resourcesSupported": boolean } ``` #### BadRequestException-Schema ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException-Schema ``` { "message": "string", "errorCode": "string" } ``` #### ConflictException-Schema ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException-Schema ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException-Schema ``` { "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. | ### Capability Werte, die angegeben werden müssen, um einige Anwendungen bereitzustellen. + `CAPABILITY_IAM` + `CAPABILITY_NAMED_IAM` + `CAPABILITY_AUTO_EXPAND` + `CAPABILITY_RESOURCE_POLICY` ### ConflictException Die Ressource ist bereits vorhanden. | Eigenschaft | Typ | Erforderlich | Beschreibung | | --- |--- |--- |--- | | errorCode | Zeichenfolge | Falsch | 409 | | message | Zeichenfolge | Falsch | Die Ressource ist bereits vorhanden. | ### CreateApplicationVersionInput Erstellen Sie eine Versionsanfrage. | Eigenschaft | Typ | Erforderlich | Beschreibung | | --- |--- |--- |--- | | sourceCodeArchiveUrl | Zeichenfolge | Falsch | Ein Link zum S3-Objekt, das das ZIP-Archiv des Quellcodes für diese Version Ihrer Anwendung enthält.
Maximale Größe 50 MB | | sourceCodeUrl | Zeichenfolge | Falsch | Ein Link zu einem öffentlichen Repository für den Quellcode Ihrer Anwendung, z. B. die URL eines bestimmten GitHub Commits. | | templateBody | Zeichenfolge | Falsch | Die AWS SAM unformatierte Paketvorlage Ihrer Anwendung. | | templateUrl | Zeichenfolge | Falsch | Ein Link zur verpackten AWS SAM Vorlage Ihrer Anwendung. | ### 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. | ### ParameterDefinition Von der Anwendung unterstützte Parameter. | Eigenschaft | Typ | Erforderlich | Beschreibung | | --- |--- |--- |--- | | allowedPattern | Zeichenfolge | Falsch | Gibt einen regulären Ausdruck an, der die zulässigen Muster für `String`-Typen beschreibt. | | allowedValues | Array vom Typ string | Falsch | Gibt ein Array mit einer Liste der für den Parameter zulässigen Werte an. | | constraintDescription | Zeichenfolge | Falsch | Gibt eine Zeichenfolge als Beschreibung für eine Einschränkung an. Diese Beschreibung wird bei Verstößen gegen die Einschränkung angezeigt. Für einen Parameter mit einem zulässigen Muster `[A-Za-z0-9]+` beispielsweise wird ohne Einschränkungsbeschreibung die folgende Fehlermeldung angezeigt, wenn der Benutzer einen ungültigen Wert angibt:
`Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+`
Durch Hinzufügen einer Beschränkungsbeschreibung, z. B. „darf nur Groß- und Kleinbuchstaben und Zahlen enthalten“, können Sie die folgende benutzerdefinierte Fehlermeldung anzeigen:
`Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.` | | defaultValue | Zeichenfolge | Falsch | Gibt einen Wert des entsprechenden Typs an, den die Vorlage nutzen soll, wenn zum Zeitpunkt der Stack-Erstellung kein Wert angegeben wird. Wenn Sie Einschränkungen für den Parameter definieren, müssen Sie einen Wert angeben, der diese Einschränkungen einhält. | | description | Zeichenfolge | Falsch | Eine Zeichenfolge mit bis zu 4.000 Zeichen, die den Parameter beschreibt. | | maxLength | Ganzzahl | Falsch | Ein ganzzahliger Wert, der die größte Anzahl von Zeichen bestimmt, die Sie für `String` Typen zulassen möchten. | | maxValue | Ganzzahl | Falsch | Ein numerischer Wert, der den größten numerischen Wert bestimmt, den Sie für `Number` Typen zulassen möchten. | | minLength | Ganzzahl | Falsch | Ein ganzzahliger Wert, der die kleinste Anzahl von Zeichen bestimmt, die Sie für `String` Typen zulassen möchten. | | minValue | Ganzzahl | Falsch | Ein numerischer Wert, der den kleinsten numerischen Wert bestimmt, den Sie für `Number` Typen zulassen möchten. | | name | Zeichenfolge | Wahr | Der Name des Parameters. | | noEcho | boolesch | Falsch | Ob der Parameterwert maskiert werden soll, wenn jemand einen Aufruf tätigt, der den Stack beschreibt. Wenn Sie den Wert auf true setzen, wird der Parameterwert mit Sternchen (\*\*\*\*\*) maskiert. | | referencedByResources | Array vom Typ string | Wahr | Eine Liste von AWS SAM Ressourcen, die diesen Parameter verwenden. | | type | Zeichenfolge | Falsch | Der Typ des Parameters.
Zulässige Werte: `String \| Number \| List \| CommaDelimitedList`
`String`: Eine wörtliche Zeichenfolge.
Benutzer können beispielsweise angeben`"MyUserName"`.
`Number`: Eine Ganzzahl oder eine Fließkommazahl. CloudFormation validiert den Parameterwert als Zahl. Wenn Sie den Parameter jedoch an einer anderen Stelle in Ihrer Vorlage verwenden (z. B. mithilfe der `Ref` systeminternen Funktion), wird der Parameterwert zu einer Zeichenfolge.
Benutzer könnten beispielsweise angeben. `"8888"`
`List`: Eine Reihe von Ganzzahlen oder Gleitkommazahlen, die durch Kommas getrennt sind. CloudFormation validiert den Parameterwert als Zahlen. Wenn Sie den Parameter jedoch an einer anderen Stelle in Ihrer Vorlage verwenden (z. B. mithilfe der `Ref` systeminternen Funktion), wird der Parameterwert zu einer Liste von Zeichenfolgen.
Benutzer könnten beispielsweise „80,20" angeben und dann das Ergebnis anzeigen. `Ref` `["80","20"]`
`CommaDelimitedList`: Ein Array von Literalzeichenfolgen, die durch Kommas getrennt sind. Die Gesamtanzahl von Zeichenfolgen sollte um 1 höher sein als die Gesamtanzahl von Kommas. Außerdem wird jede Elementzeichenfolge durch Leerzeichen gekürzt.
Benutzer könnten beispielsweise „test, dev, prod“ angeben und dann die Ergebnisse angeben. `Ref` `["test","dev","prod"]` | ### 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. | ### Version Einzelheiten zur Anwendungsversion. | Eigenschaft | Typ | Erforderlich | Beschreibung | | --- |--- |--- |--- | | applicationId | Zeichenfolge | Wahr | Der Amazon-Ressourcenname (ARN) der -Anwendung | | creationTime | Zeichenfolge | Wahr | Datum und Uhrzeit der Erstellung dieser Ressource. | | parameterDefinitions | Array vom Typ [ParameterDefinition](#applications-applicationid-versions-semanticversion-model-parameterdefinition) | Wahr | Eine Reihe von Parametertypen, die von der Anwendung unterstützt werden. | | requiredCapabilities | Array vom Typ [Capability](#applications-applicationid-versions-semanticversion-model-capability) | Wahr | 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_IAM``CAPABILITY_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::InstanceProfile](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html), [AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html), 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 `CAPABILITY_IAM` oder `CAPABILITY_NAMED_IAM` angeben. 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS: :IAM:Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html),,, [AWS::ApplicationAutoScaling::ScalingPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), [AWS::S3::BucketPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)und. [AWS::SQS::QueuePolicy[AWS::SNS::TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)
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. | | resourcesSupported | boolesch | Wahr | Ob alle in dieser Anwendung enthaltenen AWS Ressourcen in der Region unterstützt werden, in der sie abgerufen wird. | | semanticVersion | Zeichenfolge | Wahr | Die semantische Version der Anwendung:
[https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | Zeichenfolge | Falsch | Ein Link zum S3-Objekt, das das ZIP-Archiv des Quellcodes für diese Version Ihrer Anwendung enthält.
Maximale Größe 50 MB | | sourceCodeUrl | Zeichenfolge | Falsch | Ein Link zu einem öffentlichen Repository für den Quellcode Ihrer Anwendung, z. B. die URL eines bestimmten GitHub Commits. | | templateUrl | Zeichenfolge | Wahr | Ein Link zur verpackten AWS SAM Vorlage Ihrer Anwendung. | ## Weitere Informationen finden Sie auch unter Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs sowie Referenzen finden Sie im Folgenden: ### CreateApplicationVersion + [AWS-Befehlszeilenschnittstelle V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS SDK for .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS SDK für C\+\+](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS-SDK SDK for Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS SDK für Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS-SDK für JavaScript Version 3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS-SDK für Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS SDK für PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS SDK für Python](/goto/boto3/serverlessrepo-2017-09-08/CreateApplicationVersion) + [AWS SDK für Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplicationVersion)