

Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS endet der Support für AWS Proton. Nach dem 7. Oktober 2026 werden Sie nicht mehr auf die AWS Proton Konsole oder AWS Proton die Ressourcen zugreifen können. Ihre bereitgestellte Infrastruktur bleibt intakt. Weitere Informationen finden Sie im [AWS Proton Service Deprecation and Migration Guide. ](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)

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.

# Eine Dienstinstanz aktualisieren
<a name="ag-svc-instance-update"></a>

Erfahren Sie, wie Sie eine AWS Proton Dienstinstanz aktualisieren und das Update abbrechen.

Eine Dienstinstanz gehört zu einem Dienst. Sie können eine Instanz nur im Kontext von [ Aktionen zum [ Bearbeiten](ag-svc-update.md), [ Erstellen ](ag-create-svc.md) und ](ag-svc-delete.md) Löschen von Diensten erstellen oder löschen. Informationen zum Hinzufügen und Entfernen von Instanzen zu einem Service finden Sie unter[Einen Dienst bearbeiten](ag-svc-update.md).

Es gibt vier Modi zum Aktualisieren einer Dienstinstanz, wie in der folgenden Liste beschrieben. Bei Verwendung von definiert das `deployment-type` Feld den Modus. AWS CLI Bei Verwendung der Konsole sind diese Modi den ** Aktionen ** „Bearbeiten“ ** und „Auf neueste Nebenversion ** aktualisieren“ ** und „Auf neueste Hauptversion ** aktualisieren“ zugeordnet, die auf der Seite „**Aktionen**“ auf der Detailseite der Serviceinstanz aufgerufen werden.

  
`NONE`  
In diesem Modus findet * keine Bereitstellung * statt. Nur die angeforderten Metadatenparameter werden aktualisiert.

  
`CURRENT_VERSION`  
In diesem Modus wird die Dienstinstanz bereitgestellt und mit der neuen Spezifikation, die Sie angeben, aktualisiert. Nur angeforderte Parameter werden aktualisiert. *Geben Sie keine * Neben- oder Hauptversionsparameter an, wenn Sie dies verwenden`deployment-type`.

  
`MINOR_VERSION`  
In diesem Modus wird die Dienstinstanz bereitgestellt und mit der veröffentlichten, empfohlenen (neuesten) Nebenversion der aktuell verwendeten Hauptversion standardmäßig aktualisiert. Sie können auch eine andere Nebenversion der aktuell verwendeten Hauptversion angeben.

  
`MAJOR_VERSION`  
In diesem Modus wird die Dienstinstanz standardmäßig mit der veröffentlichten, empfohlenen (neuesten) Haupt- und Nebenversion der aktuellen Vorlage bereitgestellt und aktualisiert. Sie können auch eine andere Hauptversion angeben, die höher ist als die verwendete Hauptversion, und eine Nebenversion (optional).

Sie können versuchen, die Bereitstellung eines Service Instance-Updates abzubrechen, falls dies der Fall `deploymentStatus` ist`IN_PROGRESS`. AWS Proton versucht, die Bereitstellung abzubrechen. Eine erfolgreiche Stornierung * ist nicht * garantiert.

Wenn Sie eine Aktualisierungsbereitstellung abbrechen, wird AWS Proton versucht, die Bereitstellung abzubrechen, wie in den folgenden Schritten aufgeführt.
+ Setzt den Bereitstellungsstatus auf`CANCELLING`.
+ Stoppt die laufende Bereitstellung und löscht alle neuen Ressourcen, die bei der Bereitstellung erstellt wurden, wenn`IN_PROGRESS`.
+ Setzt den Bereitstellungsstatus auf`CANCELLED`.
+ Setzt den Zustand der Ressource auf den Zustand vor dem Start der Bereitstellung zurück.

Weitere Informationen zum Abbrechen einer Service-Instance-Bereitstellung finden Sie [ CancelServiceInstanceDeployment ](https://docs.aws.amazon.com/proton/latest/APIReference/API_CancelServiceInstanceDeployment.html) in der *AWS Proton API-Referenz. *

**Verwenden Sie die Konsole oder AWS CLI um Aktualisierungen vorzunehmen oder Aktualisierungsbereitstellungen abzubrechen. **

------
#### [ AWS-Managementkonsole ]

**Aktualisieren Sie eine Dienstinstanz mithilfe der Konsole, indem Sie die folgenden Schritte ausführen. **

1. Wählen Sie in der [AWS Proton Konsole ](https://console.aws.amazon.com/proton/) ** im Navigationsbereich ** Service instances aus.

1. Wählen Sie in der Liste der Dienstinstanzen den Namen der Dienstinstanz aus, die Sie aktualisieren möchten.

1. Wählen Sie ** Aktionen ** und dann eine der Aktualisierungsoptionen, ** Bearbeiten, ** um die Spezifikation zu aktualisieren, oder ** Aktionen ** und dann ** Auf neueste Nebenversion ** ** aktualisieren oder Auf neueste Hauptversion ** aktualisieren.

1. Füllen Sie jedes Formular aus und klicken Sie auf ** Weiter, ** bis Sie zur ** Seite ** „Überprüfen“ gelangen.

1. Überprüfe deine Änderungen und wähle „**Aktualisieren**“.

------
#### [ AWS CLI ]

**Aktualisieren Sie eine Dienstinstanz auf eine neue Nebenversion, wie in den CLI-Beispielbefehlen und -antworten gezeigt. **

Wenn Sie Ihre Service-Instanz mit einer geänderten Version aktualisieren`spec`, können Sie `"${Proton::CURRENT_VAL}"` damit angeben, welche Parameterwerte vom Original beibehalten werden sollen`spec`, sofern die Werte in der vorhanden sind`spec`. Wird verwendet`get-service`, um das Original `spec` für eine Dienstinstanz anzuzeigen, wie unter beschrieben[Servicedaten anzeigen](ag-svc-view.md).

Das folgende Beispiel zeigt, wie Sie es `"${Proton::CURRENT_VAL}"` in einem verwenden können`spec`.

Spezifikation:

```
proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "${Proton::CURRENT_VAL}"
  my_sample_pipeline_required_input: "${Proton::CURRENT_VAL}"

instances:
  - name: "my-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_optional_input: "${Proton::CURRENT_VAL}"
      my_sample_service_instance_required_input: "${Proton::CURRENT_VAL}"
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"
```

Befehl: aktualisieren

```
$ aws proton update-service-instance \
    --name "{{instance-one}}" \
    --service-name "{{simple-svc}}" \
    --spec "{{file://service-spec.yaml}}" \
    --template-major-version "{{1}}" \
    --template-minor-version "{{1}}" \
    --deployment-type "{{MINOR_VERSION}}"
```

Antwort:

```
{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "IN_PROGRESS",
        "environmentName": "arn:aws:proton:region-id:123456789012:environment/simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "svc-simple"
    }
}
```

Befehl: um den Status abzurufen und zu bestätigen

```
$ aws proton get-service-instance \
    --name "{{instance-one}}" \
    --service-name "{{simple-svc}}"
```

Antwort:

```
{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\n\npipeline:\n  my_sample_pipeline_optional_input: \"abc\"\n  my_sample_pipeline_required_input: \"123\"\n\ninstances:\n  - name: \"instance-one\"\n    environment: \"simple-env\"\n    spec:\n      my_sample_service_instance_optional_input: \"def\"\n      my_sample_service_instance_required_input: \"456\"\n  - name: \"my-other-instance\"\n    environment: \"kls-simple-env\"\n    spec:\n      my_sample_service_instance_required_input: \"789\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}
```

------

------
#### [ AWS-Managementkonsole ]

**Brechen Sie die Bereitstellung einer Dienstinstanz mithilfe der Konsole ab, wie in den folgenden Schritten gezeigt. **

1. Wählen Sie in der [AWS Proton Konsole ](https://console.aws.amazon.com/proton/) ** im Navigationsbereich ** Service instances aus.

1. Wählen Sie in der Liste der Dienstinstanzen den Namen der Dienstinstanz mit dem Bereitstellungsupdate aus, das Sie stornieren möchten.

1. Wenn Ihr Update-Bereitstellungsstatus ** In Bearbeitung lautet**, wählen Sie auf der Detailseite der Serviceinstanz ** Aktionen ** und dann Bereitstellung ** abbrechen aus**.

1. In einem Modal werden Sie aufgefordert, die Stornierung zu bestätigen. Wählen Sie Bereitstellung ** abbrechen aus**.

1. Ihr Status für die Bereitstellung des Updates wird auf ** Storniert ** und dann auf ** Storniert gesetzt**, um die Stornierung abzuschließen.

------
#### [ AWS CLI ]

**Brechen Sie ein Update zur Bereitstellung der IN\_PROGRESS-Dienstinstanz auf die neue Nebenversion 2 ab, wie in den folgenden CLI-Beispielbefehlen und -antworten gezeigt. **

Die für dieses Beispiel verwendete Vorlage enthält eine Wartebedingung, sodass der Abbruch beginnt, bevor die Aktualisierungsbereitstellung erfolgreich ist.

Befehl: um abzubrechen

```
$ aws proton cancel-service-instance-deployment \
    --service-instance-name "{{instance-one}}" \
    --service-name "{{simple-svc}}"
```

Antwort:

```
{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "CANCELLING",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\npipeline:\n  my_sample_pipeline_optional_input: abc\n  my_sample_pipeline_required_input: '123'\ninstances:\n- name: my-instance\n  environment: MySimpleEnv\n  spec:\n    my_sample_service_instance_optional_input: def\n    my_sample_service_instance_required_input: '456'\n- name: my-other-instance\n  environment: MySimpleEnv\n  spec:\n    my_sample_service_instance_required_input: '789'\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}
```

Befehl: um den Status abzurufen und zu bestätigen

```
$ aws proton get-service-instance \
    --name "{{instance-one}}" \
    --service-name "{{simple-svc}}"
```

Antwort:

```
{
    "serviceInstance": {
        "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
        "createdAt": "2021-04-02T21:29:59.962000+00:00",
        "deploymentStatus": "CANCELLED",
        "deploymentStatusMessage": "User initiated cancellation.",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\n\npipeline:\n  my_sample_pipeline_optional_input: \"abc\"\n  my_sample_pipeline_required_input: \"123\"\n\ninstances:\n  - name: \"instance-one\"\n    environment: \"simple-env\"\n    spec:\n      my_sample_service_instance_optional_input: \"def\"\n      my_sample_service_instance_required_input: \"456\"\n  - name: \"my-other-instance\"\n    environment: \"kls-simple-env\"\n    spec:\n      my_sample_service_instance_required_input: \"789\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}
```

------