

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.

# Anwendungs-ID-Änderungssätze
<a name="applications-applicationid-changesets"></a>

## URI
<a name="applications-applicationid-changesets-url"></a>

`/applications/applicationId/changesets`

## HTTP-Methoden
<a name="applications-applicationid-changesets-http-methods"></a>

### POST
<a name="applications-applicationid-changesetspost"></a>

**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
<a name="applications-applicationid-changesetsoptions"></a>


**Pfadparameter**  

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


**Antworten**  

| Statuscode | Antwortmodell | Description | 
| --- |--- |--- |
| 200 | Keine | Antwort 200 | 

## Schemata
<a name="applications-applicationid-changesets-schemas"></a>

### Anfragetexte
<a name="applications-applicationid-changesets-request-examples"></a>

#### POST-Schema
<a name="applications-applicationid-changesets-request-body-post-example"></a>

```
{
  "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
<a name="applications-applicationid-changesets-response-examples"></a>

#### ChangeSetDetails-Schema
<a name="applications-applicationid-changesets-response-body-changesetdetails-example"></a>

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

#### BadRequestException-Schema
<a name="applications-applicationid-changesets-response-body-badrequestexception-example"></a>

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

#### ForbiddenException-Schema
<a name="applications-applicationid-changesets-response-body-forbiddenexception-example"></a>

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

#### TooManyRequestsException-Schema
<a name="applications-applicationid-changesets-response-body-toomanyrequestsexception-example"></a>

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

#### InternalServerErrorException-Schema
<a name="applications-applicationid-changesets-response-body-internalservererrorexception-example"></a>

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

## Eigenschaften
<a name="applications-applicationid-changesets-properties"></a>

### BadRequestException
<a name="applications-applicationid-changesets-model-badrequestexception"></a>

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
<a name="applications-applicationid-changesets-model-changesetdetails"></a>

Einzelheiten 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:/] \$1 | 
| semanticVersion | Zeichenfolge | Wahr | Die semantische Version der Anwendung: [https://semver.org/](https://semver.org/)  | 
| stackId | Zeichenfolge | Wahr | Die eindeutige ID des Stacks. | 

### CreateCloudFormationChangeSetInput
<a name="applications-applicationid-changesets-model-createcloudformationchangesetinput"></a>

Erstellen Sie eine Anfrage für ein 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 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`CAPABILITY_RESOURCE_POLICY`: [AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS: :IAM:Policy,,, [AWS::ApplicationAutoScaling::ScalingPolicy[AWS::S3::BucketPolicy[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), und [AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html): :SNS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html): angeben. TopicPolicyBei 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 | Falsch | Diese Eigenschaft entspricht dem gleichnamigen Parameter für die *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| clientToken | Zeichenfolge | Falsch | Diese Eigenschaft entspricht dem gleichnamigen Parameter für die *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| description | Zeichenfolge | Falsch | Diese Eigenschaft entspricht dem gleichnamigen Parameter für die *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| notificationArns | Array vom Typ string | Falsch | Diese Eigenschaft entspricht dem gleichnamigen Parameter für die *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| parameterOverrides | Array vom Typ [ParameterValue](#applications-applicationid-changesets-model-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](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| rollbackConfiguration | [RollbackConfiguration](#applications-applicationid-changesets-model-rollbackconfiguration) | Falsch | Diese Eigenschaft entspricht dem gleichnamigen Parameter für die *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| semanticVersion | Zeichenfolge | Falsch | Die semantische Version der Anwendung: [https://semver.org/](https://semver.org/)  | 
| stackName | Zeichenfolge | Wahr | Diese Eigenschaft entspricht dem gleichnamigen Parameter für die *CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| tags | Array vom Typ [Tag](#applications-applicationid-changesets-model-tag) | Falsch | Diese Eigenschaft entspricht dem gleichnamigen Parameter für die *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| templateId | Zeichenfolge | Falsch | Die von zurückgegebene UUID. CreateCloudFormationTemplateMuster: [0-9a-fa-F] \$18\$1\$1 - [0-9a-fa-F] \$14\$1\$1 - [0-9a-fa-F] \$14\$1\$1 - [0-9a-fa-F] \$14\$1\$1 - [0-9a-fa-F] \$112\$1 | 

### ForbiddenException
<a name="applications-applicationid-changesets-model-forbiddenexception"></a>

Der Client ist nicht authentifiziert.


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

### InternalServerErrorException
<a name="applications-applicationid-changesets-model-internalservererrorexception"></a>

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
<a name="applications-applicationid-changesets-model-parametervalue"></a>

Parameterwert der Anwendung.


| Eigenschaft | Typ | Erforderlich | Beschreibung | 
| --- |--- |--- |--- |
| name | Zeichenfolge | Wahr | 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 CloudFormation verwendet, der in Ihrer Vorlage angegeben ist. | 
| value | Zeichenfolge | Wahr | Der dem Parameter zugeordnete Eingabewert. | 

### RollbackConfiguration
<a name="applications-applicationid-changesets-model-rollbackconfiguration"></a>

Diese Eigenschaft entspricht dem *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*Datentyp.


| Eigenschaft | Typ | Erforderlich | Description | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | Ganzzahl | Falsch | Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*Datentyp. | 
| rollbackTriggers | Array vom Typ [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) | Falsch | Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*Datentyp. | 

### RollbackTrigger
<a name="applications-applicationid-changesets-model-rollbacktrigger"></a>

Diese Eigenschaft entspricht dem *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*Datentyp.


| Eigenschaft | Typ | Erforderlich | Beschreibung | 
| --- |--- |--- |--- |
| arn | Zeichenfolge | Wahr | Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*Datentyp. | 
| type | Zeichenfolge | Wahr | Diese Eigenschaft entspricht dem gleichnamigen Inhalt für den *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*Datentyp. | 

### Tag
<a name="applications-applicationid-changesets-model-tag"></a>

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


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

### TooManyRequestsException
<a name="applications-applicationid-changesets-model-toomanyrequestsexception"></a>

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
<a name="applications-applicationid-changesets-see-also"></a>

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

### CreateCloudFormationChangeSet
<a name="CreateCloudFormationChangeSet-see-also"></a>
+ [AWS-Befehlszeilenschnittstelle V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK für C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS-SDK SDK for Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK für Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS-SDK für JavaScript Version 3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS-SDK für Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK für PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK für Python](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK für Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)