Beispiele für die Verwendung der AWS CLI mit AWS AppConfig - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit AWS AppConfig

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit AWS AppConfig nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie create-application verwendet wird.

AWS CLI

So erstellen Sie eine Anwendung

Im folgenden Beispiel für create-application wird eine Anwendung in AWS AppConfig erstellt.

aws appconfig create-application \
    --name "example-application" \
    --description "An application used for creating an example."

Ausgabe:

{
    "Description": "An application used for creating an example.",
    "Id": "339ohji",
    "Name": "example-application"
}

Weitere Informationen finden Sie unter Schritt 1: Erstellen einer AWS-AppConfig-Anwendung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie create-configuration-profile verwendet wird.

AWS CLI

So erstellen Sie ein Konfigurationsprofil

Im folgenden Beispiel für create-configuration-profile wird ein Konfigurationsprofil mithilfe einer Konfiguration erstellt, die in Parameter Store, einer Funktion von Systems Manager, gespeichert ist.

aws appconfig create-configuration-profile \
    --application-id "339ohji" \
    --name "Example-Configuration-Profile" \
    --location-uri "ssm-parameter://Example-Parameter" \
    --retrieval-role-arn "arn:aws:iam::111122223333:role/Example-App-Config-Role"

Ausgabe:

{
    "ApplicationId": "339ohji",
    "Description": null,
    "Id": "ur8hx2f",
    "LocationUri": "ssm-parameter://Example-Parameter",
    "Name": "Example-Configuration-Profile",
    "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role",
    "Type": null,
    "Validators": null
}

Weitere Informationen finden Sie unter Schritt 3: Erstellen einer Konfiguration und eines Konfigurationsprofils im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie create-environment verwendet wird.

AWS CLI

So erstellen Sie eine Umgebung

Im folgenden Beispiel für create-environment wird mithilfe der Anwendung, die Sie mit create-application erstellt haben, eine AWS-AppConfig-Umgebung mit dem Namen Example-Environment erstellt.

aws appconfig create-environment \
    --application-id "339ohji" \
    --name "Example-Environment"

Ausgabe:

{
    "ApplicationId": "339ohji",
    "Description": null,
    "Id": "54j1r29",
    "Monitors": null,
    "Name": "Example-Environment",
    "State": "ReadyForDeployment"
}

Weitere Informationen finden Sie unter Schritt 2: Erstellen einer Umgebung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie create-extension-association verwendet wird.

AWS CLI

So erstellen Sie eine Erweiterungszuordnung

Im folgenden Beispiel für create-extension-association wird eine neue Erweiterungszuordnung in AWS AppConfig erstellt.

aws appconfig create-extension-association \
    --region us-west-2 \
    --extension-identifier S3-backup-extension \
    --resource-identifier "arn:aws:appconfig:us-west-2:123456789012:application/Finance" \
    --parameters S3bucket=FinanceConfigurationBackup

Ausgabe:

{
  "Id": "a1b2c3d4",
  "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
  "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance",
  "Parameters": {
    "S3bucket": "FinanceConfigurationBackup"
  },
  "ExtensionVersionNumber": 1
}

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie create-extension verwendet wird.

AWS CLI

So erstellen Sie eine Erweiterung

Im folgenden Beispiel für create-extension wird eine neue Erweiterung in AWS AppConfig erstellt.

aws appconfig create-extension \
    --region us-west-2 \
    --name S3-backup-extension \
    --actions PRE_CREATE_HOSTED_CONFIGURATION_VERSION=[{Name=S3backup,Uri=arn:aws:lambda:us-west-2:123456789012:function:s3backupfunction,RoleArn=arn:aws:iam::123456789012:role/appconfigextensionrole}] \
    --parameters S3bucket={Required=true}

Ausgabe:

{
    "Id": "1A2B3C4D",
    "Name": "S3-backup-extension",
    "VersionNumber": 1,
    "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1",
    "Actions": {
        "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [
            {
                "Name": "S3backup",
                "Uri": "arn:aws:lambda:us-west-2:123456789012:function:s3backupfunction",
                "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole"
            }
        ]
    },
    "Parameters": {
        "S3bucket": {
            "Required": true
        }
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter CreateExtension in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-hosted-configuration-version verwendet wird.

AWS CLI

So erstellen Sie eine gehostete Konfigurationsversion

Im folgenden Beispiel für create-hosted-configuration-version wird eine neue Konfiguration im gehosteten Konfigurationsspeicher von AWS AppConfig erstellt. Der Konfigurationsinhalt muss zuerst in base64 konvertiert werden.

aws appconfig create-hosted-configuration-version \
    --application-id "339ohji" \
    --configuration-profile-id "ur8hx2f" \
    --content eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9 \
    --content-type "application/json" \
    configuration_version_output_file

Inhalt von configuration_version_output_file:

{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }

Ausgabe:

{
    "ApplicationId": "339ohji",
    "ConfigurationProfileId": "ur8hx2f",
    "VersionNumber": "1",
    "ContentType": "application/json"
}

Weitere Informationen finden Sie unter Über den gehosteten Konfigurationsspeicher von AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie delete-application verwendet wird.

AWS CLI

So löschen Sie eine Anwendung

Im folgenden Beispiel für delete-application wird die angegebene Anwendung gelöscht.

aws appconfig delete-application \
--application-id 339ohji

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schritt 1: Erstellen einer AWS-AppConfig-Anwendung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie delete-configuration-profile verwendet wird.

AWS CLI

So löschen Sie ein Konfigurationsprofil

Im folgenden Beispiel für delete-configuration-profile wird das angegebene Konfigurationsprofil gelöscht.

aws appconfig delete-configuration-profile \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schritt 3: Erstellen einer Konfiguration und eines Konfigurationsprofils im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie delete-deployment-strategy verwendet wird.

AWS CLI

So löschen Sie eine Bereitstellungsstrategie

Im folgenden Beispiel für delete-deployment-strategy wird die angegebene Bereitstellungsstrategie gelöscht.

aws appconfig delete-deployment-strategy \
    --deployment-strategy-id 1225qzk

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schritt 4: Erstellen einer Bereitstellungsstrategie im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie delete-environment verwendet wird.

AWS CLI

So löschen Sie eine Umgebung

Im folgenden Beispiel für delete-environment wird die angegebene Anwendungsumgebung gelöscht.

aws appconfig delete-environment \
    --application-id 339ohji \
    --environment-id 54j1r29

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schritt 2: Erstellen einer Umgebung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie delete-extension-association verwendet wird.

AWS CLI

So löschen Sie eine Erweiterungszuordnung

Im folgenden Beispiel für delete-extension-association wird eine Erweiterungszuordnung aus AWS AppConfig gelöscht.

aws appconfig delete-extension-association \
    --region us-west-2 \
    --extension-association-id a1b2c3d4

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie delete-extension verwendet wird.

AWS CLI

So löschen Sie eine Erweiterung

Im folgenden Beispiel für delete-extension wird eine Erweiterung aus AWS AppConfig gelöscht.

aws appconfig delete-extension \
    --region us-west-2 \
    --extension-identifier S3-backup-extension

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter DeleteExtension in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-hosted-configuration-version verwendet wird.

AWS CLI

So löschen Sie eine gehostete Konfigurationsversion

Im folgenden Beispiel für delete-hosted-configuration-version wird eine im gehosteten Konfigurationsspeicher von AWS AppConfig gehostete Konfigurationsversion gelöscht.

aws appconfig delete-hosted-configuration-version \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f \
    --version-number 1

Ausgabe: Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schritt 3: Erstellen einer Konfiguration und eines Konfigurationsprofils im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie get-application verwendet wird.

AWS CLI

So listen Sie die Details einer Anwendung auf

Im folgenden Beispiel für get-application werden die Details der angegebenen Anwendung aufgelistet.

aws appconfig get-application \
    --application-id 339ohji

Ausgabe:

{
    "Description": "An application used for creating an example.",
    "Id": "339ohji",
    "Name": "example-application"
}

Weitere Informationen finden Sie unter Funktionsweise von AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter GetApplication in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-configuration-profile verwendet wird.

AWS CLI

So rufen Sie Details zum Konfigurationsprofil ab

Im folgenden Beispiel für get-configuration-profile werden die Details zum angegebenen Konfigurationsprofil zurückgegeben.

aws appconfig get-configuration-profile \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f

Ausgabe:

{
    "ApplicationId": "339ohji",
    "Id": "ur8hx2f",
    "Name": "Example-Configuration-Profile",
    "LocationUri": "ssm-parameter://Example-Parameter",
    "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role"
}

Weitere Informationen finden Sie unter Schritt 3: Erstellen einer Konfiguration und eines Konfigurationsprofils im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie get-configuration verwendet wird.

AWS CLI

So rufen Sie Konfigurationsdetails ab

Im folgenden Beispiel für get-configuration werden die Konfigurationsdetails der Beispielanwendung zurückgegeben. Verwenden Sie bei nachfolgenden Aufrufen von get-configuration den client-configuration-version-Parameter, um die Konfiguration Ihrer Anwendung nur zu aktualisieren, wenn sich die Version geändert hat. Wenn Sie die Konfiguration nur aktualisieren, wenn sich die Version geändert hat, werden zusätzliche Kosten vermieden, die durch den Aufruf von get-configuration entstehen.

aws appconfig get-configuration \
    --application "example-application" \
    --environment "Example-Environment" \
    --configuration "Example-Configuration-Profile" \
    --client-id "test-id" \
    configuration-output-file

Inhalt von configuration-output-file:

{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }

Ausgabe:

{
    "ConfigurationVersion": "1",
    "ContentType": "application/json"
}

Weitere Informationen finden Sie unter Schritt 6: Empfangen der Konfiguration im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie get-deployment-strategy verwendet wird.

AWS CLI

So rufen Sie Details einer Bereitstellungsstrategie ab

Im folgenden Beispiel für get-deployment-strategy werden die Details der angegebenen Bereitstellungsstrategie aufgelistet.

aws appconfig get-deployment-strategy \
    --deployment-strategy-id 1225qzk

Ausgabe:

{
    "Id": "1225qzk",
    "Name": "Example-Deployment",
    "DeploymentDurationInMinutes": 15,
    "GrowthType": "LINEAR",
    "GrowthFactor": 25.0,
    "FinalBakeTimeInMinutes": 0,
    "ReplicateTo": "SSM_DOCUMENT"
}

Weitere Informationen finden Sie unter Schritt 4: Erstellen einer Bereitstellungsstrategie im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie get-deployment verwendet wird.

AWS CLI

So rufen Sie Bereitstellungsdetails ab

Im folgenden Beispiel für get-deployment werden Details zur Bereitstellung für die Anwendung in der angegebenen Umgebung und Bereitstellung aufgelistet.

aws appconfig get-deployment \
    --application-id 339ohji \
    --environment-id 54j1r29 \
    --deployment-number 1

Ausgabe:

{
    "ApplicationId": "339ohji",
    "EnvironmentId": "54j1r29",
    "DeploymentStrategyId": "1225qzk",
    "ConfigurationProfileId": "ur8hx2f",
    "DeploymentNumber": 1,
    "ConfigurationName": "Example-Configuration-Profile",
    "ConfigurationLocationUri": "ssm-parameter://Example-Parameter",
    "ConfigurationVersion": "1",
    "DeploymentDurationInMinutes": 15,
    "GrowthType": "LINEAR",
    "GrowthFactor": 25.0,
    "FinalBakeTimeInMinutes": 0,
    "State": "COMPLETE",
    "EventLog": [
        {
            "EventType": "DEPLOYMENT_COMPLETED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Deployment completed",
            "OccurredAt": "2021-09-17T21:59:03.888000+00:00"
        },
        {
            "EventType": "BAKE_TIME_STARTED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Deployment bake time started",
            "OccurredAt": "2021-09-17T21:58:57.722000+00:00"
        },
        {
            "EventType": "PERCENTAGE_UPDATED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Configuration available to 100.00% of clients",
            "OccurredAt": "2021-09-17T21:55:56.816000+00:00"
        },
        {
            "EventType": "PERCENTAGE_UPDATED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Configuration available to 75.00% of clients",
            "OccurredAt": "2021-09-17T21:52:56.567000+00:00"
        },
        {
            "EventType": "PERCENTAGE_UPDATED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Configuration available to 50.00% of clients",
            "OccurredAt": "2021-09-17T21:49:55.737000+00:00"
        },
        {
            "EventType": "PERCENTAGE_UPDATED",
            "TriggeredBy": "APPCONFIG",
            "Description": "Configuration available to 25.00% of clients",
            "OccurredAt": "2021-09-17T21:46:55.187000+00:00"
        },
        {
            "EventType": "DEPLOYMENT_STARTED",
            "TriggeredBy": "USER",
            "Description": "Deployment started",
            "OccurredAt": "2021-09-17T21:43:54.205000+00:00"
        }
    ],
    "PercentageComplete": 100.0,
    "StartedAt": "2021-09-17T21:43:54.205000+00:00",
    "CompletedAt": "2021-09-17T21:59:03.888000+00:00"
}

Weitere Informationen finden Sie unter Schritt 5: Bereitstellen einer Konfiguration im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter GetDeployment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-environment verwendet wird.

AWS CLI

So rufen Sie Umgebungsdetails ab

Im folgenden Beispiel für get-environment werden die Details und der Status der angegebenen Umgebung abgerufen.

aws appconfig get-environment \
    --application-id 339ohji \
    --environment-id 54j1r29

Ausgabe:

{
    "ApplicationId": "339ohji",
    "Id": "54j1r29",
    "Name": "Example-Environment",
    "State": "ReadyForDeployment"
}

Weitere Informationen finden Sie unter Schritt 2: Erstellen einer Umgebung im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter GetEnvironment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-extension-association verwendet wird.

AWS CLI

So rufen Sie Details zur Erweiterungszuordnung ab

Im folgenden Beispiel für get-extension-association werden Informationen über eine Erweiterungszuordnung angezeigt.

aws appconfig get-extension-association \
    --region us-west-2 \
    --extension-association-id a1b2c3d4

Ausgabe:

{
    "Id": "a1b2c3d4",
    "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
    "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance",
    "Parameters": {
        "S3bucket": "FinanceConfigurationBackup"
    },
    "ExtensionVersionNumber": 1
}

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie get-extension verwendet wird.

AWS CLI

So rufen Sie Details zu einer Erweiterung ab

Im folgenden Beispiel für get-extension werden Informationen über eine Erweiterung angezeigt.

aws appconfig get-extension \
    --region us-west-2 \
    --extension-identifier S3-backup-extension

Ausgabe:

{
    "Id": "1A2B3C4D",
    "Name": "S3-backup-extension",
    "VersionNumber": 1,
    "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
    "Actions": {
        "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [
            {
                "Name": "S3backup",
                "Uri": "arn:aws:lambda:us-west-2:123456789012:function:S3backupfunction",
                "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole"
            }
        ]
    },
    "Parameters": {
        "S3bucket": {
            "Required": true
        }
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter GetExtension in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-hosted-configuration-version verwendet wird.

AWS CLI

So rufen Sie Details zur gehosteten Konfiguration ab

Im folgenden Beispiel für get-hosted-configuration-version werden die Konfigurationsdetails der von AWS AppConfig gehosteten Konfiguration abgerufen.

aws appconfig get-hosted-configuration-version \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f \
    --version-number 1 \
    hosted-configuration-version-output

Inhalt von hosted-configuration-version-output:

{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }

Ausgabe:

{
    "ApplicationId": "339ohji",
    "ConfigurationProfileId": "ur8hx2f",
    "VersionNumber": "1",
    "ContentType": "application/json"
}

Weitere Informationen finden Sie unter Über den gehosteten Konfigurationsspeicher von AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie list-applications verwendet wird.

AWS CLI

So listen Sie die verfügbaren Anwendungen auf

Im folgenden Beispiel für list-applications werden die verfügbaren Anwendungen in Ihrem AWS-Konto aufgelistet.

aws appconfig list-applications

Ausgabe:

{
    "Items": [
        {
            "Id": "339ohji",
            "Name": "test-application",
            "Description": "An application used for creating an example."
        },
        {
            "Id": "rwalwu7",
            "Name": "Test-Application"
        }
    ]
}

Weitere Informationen finden Sie unter Schritt 1: Erstellen einer AWS-AppConfig-Anwendung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie list-configuration-profiles verwendet wird.

AWS CLI

So listen Sie die verfügbaren Konfigurationsprofile auf

Im folgenden Beispiel für list-configuration-profiles werden die verfügbaren Konfigurationsprofile für die angegebene Anwendung aufgelistet.

aws appconfig list-configuration-profiles \
    --application-id 339ohji

Ausgabe:

{
    "Items": [
        {
            "ApplicationId": "339ohji",
            "Id": "ur8hx2f",
            "Name": "Example-Configuration-Profile",
            "LocationUri": "ssm-parameter://Example-Parameter"
        }
    ]
}

Weitere Informationen finden Sie unter Schritt 3: Erstellen einer Konfiguration und eines Konfigurationsprofils im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie list-deployment-strategies verwendet wird.

AWS CLI

So listen Sie die verfügbaren Bereitstellungsstrategien auf

Im folgenden Beispiel für list-deployment-strategies werden die verfügbaren Bereitstellungsstrategien in Ihrem AWS-Konto aufgelistet.

aws appconfig list-deployment-strategies

Ausgabe:

{
    "Items": [
        {
            "Id": "1225qzk",
            "Name": "Example-Deployment",
            "DeploymentDurationInMinutes": 15,
            "GrowthType": "LINEAR",
            "GrowthFactor": 25.0,
            "FinalBakeTimeInMinutes": 0,
            "ReplicateTo": "SSM_DOCUMENT"
        },
        {
            "Id": "AppConfig.AllAtOnce",
            "Name": "AppConfig.AllAtOnce",
            "Description": "Quick",
            "DeploymentDurationInMinutes": 0,
            "GrowthType": "LINEAR",
            "GrowthFactor": 100.0,
            "FinalBakeTimeInMinutes": 10,
            "ReplicateTo": "NONE"
        },
        {
            "Id": "AppConfig.Linear50PercentEvery30Seconds",
            "Name": "AppConfig.Linear50PercentEvery30Seconds",
            "Description": "Test/Demo",
            "DeploymentDurationInMinutes": 1,
            "GrowthType": "LINEAR",
            "GrowthFactor": 50.0,
            "FinalBakeTimeInMinutes": 1,
            "ReplicateTo": "NONE"
        },
        {
            "Id": "AppConfig.Canary10Percent20Minutes",
            "Name": "AppConfig.Canary10Percent20Minutes",
            "Description": "AWS Recommended",
            "DeploymentDurationInMinutes": 20,
            "GrowthType": "EXPONENTIAL",
            "GrowthFactor": 10.0,
            "FinalBakeTimeInMinutes": 10,
            "ReplicateTo": "NONE"
        }
    ]
}

Weitere Informationen finden Sie unter Schritt 4: Erstellen einer Bereitstellungsstrategie im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie list-deployments verwendet wird.

AWS CLI

So listen Sie die verfügbaren Bereitstellungen auf

Im folgenden Beispiel für list-deployments werden die verfügbaren Bereitstellungen in Ihrem AWS-Konto für die angegebene Anwendung und Umgebung aufgelistet.

aws appconfig list-deployments \
    --application-id 339ohji \
    --environment-id 54j1r29

Ausgabe:

{
    "Items": [
        {
            "DeploymentNumber": 1,
            "ConfigurationName": "Example-Configuration-Profile",
            "ConfigurationVersion": "1",
            "DeploymentDurationInMinutes": 15,
            "GrowthType": "LINEAR",
            "GrowthFactor": 25.0,
            "FinalBakeTimeInMinutes": 0,
            "State": "COMPLETE",
            "PercentageComplete": 100.0,
            "StartedAt": "2021-09-17T21:43:54.205000+00:00",
            "CompletedAt": "2021-09-17T21:59:03.888000+00:00"
        }
    ]
}

Weitere Informationen finden Sie unter Schritt 5: Bereitstellen einer Konfiguration im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter ListDeployments in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-environments verwendet wird.

AWS CLI

So listen Sie die verfügbaren Umgebungen auf

Im folgenden Beispiel für list-environments werden die verfügbaren Umgebungen in Ihrem AWS-Konto für die angegebene Anwendung aufgelistet.

aws appconfig list-environments \
    --application-id 339ohji

Ausgabe:

{
    "Items": [
        {
            "ApplicationId": "339ohji",
            "Id": "54j1r29",
            "Name": "Example-Environment",
            "State": "ReadyForDeployment"
        }
    ]
}

Weitere Informationen finden Sie unter Schritt 2: Erstellen einer Umgebung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie list-extension-associations verwendet wird.

AWS CLI

So listen Sie alle Erweiterungszuordnungen von AWS AppConfig in Ihrem AWS-Konto für eine AWS-Region auf

Im folgenden Beispiel für list-extension-associations werden alle Erweiterungszuordnungen von AWS AppConfig für das aktuelle AWS-Konto in einer bestimmten AWS-Region aufgelistet.

aws appconfig list-extension-associations \
    --region us-west-2

Ausgabe:

{
    "Items": [
        {
            "Id": "a1b2c3d4",
            "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
            "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance"
        }
    ]
}

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie list-extensions verwendet wird.

AWS CLI

So listen Sie alle Erweiterungen von AWS AppConfig in Ihrem AWS-Konto für eine AWS-Region auf

Im folgenden Beispiel für list-extensions werden alle Erweiterungen von AWS AppConfig für das aktuelle AWS-Konto in einer bestimmten AWS-Region aufgelistet. Der Befehl gibt benutzerdefinierte und von AWS erstellte Erweiterungen zurück.

aws appconfig list-extensions \
    --region us-west-2

Ausgabe:

{
    "Items": [
        {
            "Id": "1A2B3C4D",
            "Name": "S3-backup-extension",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1"
        },
        {
            "Id": "AWS.AppConfig.FeatureFlags",
            "Name": "AppConfig Feature Flags Helper",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.FeatureFlags/1",
            "Description": "Validates AppConfig feature flag data automatically against a JSON schema that includes structure and constraints. Also transforms feature flag data prior to sending to the client. This extension is automatically associated to configuration profiles with type \"AWS.AppConfig.FeatureFlags\"."
        },
        {
            "Id": "AWS.AppConfig.JiraIntegration",
            "Name": "AppConfig integration with Atlassian Jira",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.JiraIntegration/1",
            "Description": "Exports feature flag data from AWS AppConfig into Jira. The lifecycle of each feature flag in AppConfig is tracked in Jira as an individual issue. Customers can see in Jira when flags are updated, turned on or off. Works in conjunction with the AppConfig app in the Atlassian Marketplace and is automatically associated to configuration profiles configured within that app."
        },
        {
            "Id": "AWS.AppConfig.DeploymentNotificationsToEventBridge",
            "Name": "AppConfig deployment events to Amazon EventBridge",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.DeploymentNotificationsToEventBridge/1",
            "Description": "Sends events to Amazon EventBridge when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile."
        },
        {
            "Id": "AWS.AppConfig.DeploymentNotificationsToSqs",
            "Name": "AppConfig deployment events to Amazon SQS",
            "VersionNumber": 1,
            "Arn": "arn:aws:appconfig:us-west-2::extension/AWS.AppConfig.DeploymentNotificationsToSqs/1",
            "Description": "Sends messages to the configured Amazon SQS queue when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile."
        },
        {
            "Id": "AWS.AppConfig.DeploymentNotificationsToSns",
            "Name": "AppConfig deployment events to Amazon SNS",
            "VersionNumber": 1,
            "Description": "Sends events to the configured Amazon SNS topic when a deployment of configuration data in AppConfig is started, completed, or rolled back. Can be associated to the following resources in AppConfig: Application, Environment, Configuration Profile."
        }
    ]
}

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter ListExtensions in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-hosted-configuration-versions verwendet wird.

AWS CLI

So listen Sie die verfügbaren gehosteten Konfigurationsversionen auf

Im folgenden Beispiel für list-hosted-configuration-versions werden die Konfigurationsversionen aufgelistet, die im gehosteten Konfigurationsspeicher von AWS AppConfig für die angegebene Anwendung und das angegebene Konfigurationsprofil gehostet werden.

aws appconfig list-hosted-configuration-versions \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f

Ausgabe:

{
    "Items": [
        {
            "ApplicationId": "339ohji",
            "ConfigurationProfileId": "ur8hx2f",
            "VersionNumber": 1,
            "ContentType": "application/json"
        }
    ]
}

Weitere Informationen finden Sie unter Über den gehosteten Konfigurationsspeicher von AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie die Tags einer Anwendung auf

Im folgenden Beispiel für list-tags-for-resource werden die Tags einer angegebenen Anwendung aufgelistet.

aws appconfig list-tags-for-resource \
    --resource-arn arn:aws:appconfig:us-east-1:682428703967:application/339ohji

Ausgabe:

{
    "Tags": {
        "group1": "1"
    }
}

Weitere Informationen finden Sie unter Schritt 1: Erstellen einer AWS-AppConfig-Anwendung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie start-deployment verwendet wird.

AWS CLI

So starten Sie eine Konfigurationsbereitstellung

Im folgenden Beispiel für start-deployment wird eine Bereitstellung für die Anwendung unter Verwendung der angegebenen Umgebung und Bereitstellungsstrategie sowie des angegebenen Konfigurationsprofils gestartet.

aws appconfig start-deployment \
    --application-id 339ohji \
    --environment-id 54j1r29 \
    --deployment-strategy-id 1225qzk \
    --configuration-profile-id ur8hx2f \
    --configuration-version 1

Ausgabe:

{
    "ApplicationId": "339ohji",
    "EnvironmentId": "54j1r29",
    "DeploymentStrategyId": "1225qzk",
    "ConfigurationProfileId": "ur8hx2f",
    "DeploymentNumber": 1,
    "ConfigurationName": "Example-Configuration-Profile",
    "ConfigurationLocationUri": "ssm-parameter://Example-Parameter",
    "ConfigurationVersion": "1",
    "DeploymentDurationInMinutes": 15,
    "GrowthType": "LINEAR",
    "GrowthFactor": 25.0,
    "FinalBakeTimeInMinutes": 0,
    "State": "DEPLOYING",
    "EventLog": [
        {
            "EventType": "DEPLOYMENT_STARTED",
            "TriggeredBy": "USER",
            "Description": "Deployment started",
            "OccurredAt": "2021-09-17T21:43:54.205000+00:00"
        }
    ],
    "PercentageComplete": 0.0,
    "StartedAt": "2021-09-17T21:43:54.205000+00:00"
}

Weitere Informationen finden Sie unter Schritt 5: Bereitstellen einer Konfiguration im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter StartDeployment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie stop-deployment verwendet wird.

AWS CLI

So beenden Sie eine Konfigurationsbereitstellung

Im folgenden Beispiel für stop-deployment wird die Bereitstellung einer Anwendungskonfiguration in der angegebenen Umgebung beendet.

aws appconfig stop-deployment \
    --application-id 339ohji \
    --environment-id 54j1r29 \
    --deployment-number 2

Ausgabe:

{
    "DeploymentNumber": 0,
    "DeploymentDurationInMinutes": 0,
    "GrowthFactor": 0.0,
    "FinalBakeTimeInMinutes": 0,
    "PercentageComplete": 0.0
}

Weitere Informationen finden Sie unter Schritt 5: Bereitstellen einer Konfiguration im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter StopDeployment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So taggen Sie eine Anwendung

Im folgenden Beispiel für tag-resource wird eine Anwendungsressource getaggt.

aws appconfig tag-resource \
    --resource-arn arn:aws:appconfig:us-east-1:682428703967:application/339ohji \
    --tags '{"group1" : "1"}'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schritt 1: Erstellen einer AWS-AppConfig-Anwendung im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie ein Tag aus einer Anwendung

Im folgenden Beispiel für untag-resource wird das group1-Tag von der angegebenen Anwendung entfernt.

aws appconfig untag-resource \
    --resource-arn arn:aws:appconfig:us-east-1:111122223333:application/339ohji \
    --tag-keys '["group1"]'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schritt 1: Erstellen einer AWS-AppConfig-Anwendung im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-application verwendet wird.

AWS CLI

So aktualisieren Sie eine Anwendung

Im folgenden Beispiel für update-application wird der Name der angegebenen Anwendung aktualisiert.

aws appconfig update-application \
    --application-id 339ohji \
    --name "Example-Application"

Ausgabe:

{
    "Id": "339ohji",
    "Name": "Example-Application",
    "Description": "An application used for creating an example."
}

Weitere Informationen finden Sie unter Schritt 1: Erstellen einer AWS-AppConfig-Anwendung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie update-configuration-profile verwendet wird.

AWS CLI

So aktualisieren Sie ein Konfigurationsprofil

Im folgenden Beispiel für update-configuration-profile wird die Beschreibung des angegebenen Konfigurationsprofils aktualisiert.

aws appconfig update-configuration-profile \
    --application-id 339ohji \
    --configuration-profile-id ur8hx2f \
    --description "Configuration profile used for examples."

Ausgabe:

{
    "ApplicationId": "339ohji",
    "Id": "ur8hx2f",
    "Name": "Example-Configuration-Profile",
    "Description": "Configuration profile used for examples.",
    "LocationUri": "ssm-parameter://Example-Parameter",
    "RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role"
}

Weitere Informationen finden Sie unter Schritt 3: Erstellen einer Konfiguration und eines Konfigurationsprofils im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie update-deployment-strategy verwendet wird.

AWS CLI

So aktualisieren Sie eine Bereitstellungsstrategie

Im folgenden Beispiel für update-deployment-strategy wird die endgültige Bake-Zeit in der angegebenen Bereitstellungsstrategie auf 20 Minuten aktualisiert.

aws appconfig update-deployment-strategy \
    --deployment-strategy-id 1225qzk \
    --final-bake-time-in-minutes 20

Ausgabe:

{
    "Id": "1225qzk",
    "Name": "Example-Deployment",
    "DeploymentDurationInMinutes": 15,
    "GrowthType": "LINEAR",
    "GrowthFactor": 25.0,
    "FinalBakeTimeInMinutes": 20,
    "ReplicateTo": "SSM_DOCUMENT"
}

Weitere Informationen finden Sie unter Schritt 4: Erstellen einer Bereitstellungsstrategie im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie update-environment verwendet wird.

AWS CLI

So aktualisieren Sie eine Umgebung

Im folgenden Beispiel für update-environment wird die Beschreibung einer Umgebung aktualisiert.

aws appconfig update-environment \
    --application-id 339ohji \
    --environment-id 54j1r29 \
    --description "An environment for examples."

Ausgabe:

{
    "ApplicationId": "339ohji",
    "Id": "54j1r29",
    "Name": "Example-Environment",
    "Description": "An environment for examples.",
    "State": "RolledBack"
}

Weitere Informationen finden Sie unter Schritt 2: Erstellen einer Umgebung im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie update-extension-association verwendet wird.

AWS CLI

So aktualisieren Sie eine Erweiterungszuordnung von AWS AppConfig

Im folgenden Beispiel für update-extension-association wird ein neuer Parameterwert zu einer Erweiterungszuordnung in AWS AppConfig hinzugefügt.

aws appconfig update-extension-association \
    --region us-west-2 \
    --extension-association-id a1b2c3d4 \
    --parameters S3bucket=FinanceMobileApp

Ausgabe:

{
    "Id": "a1b2c3d4",
    "ExtensionArn": "arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1",
    "ResourceArn": "arn:aws:appconfig:us-west-2:123456789012:application/Finance",
    "Parameters": {
        "S3bucket": "FinanceMobileApp"
    },
    "ExtensionVersionNumber": 1
}

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

Das folgende Codebeispiel zeigt, wie update-extension verwendet wird.

AWS CLI

So aktualisieren Sie eine Erweiterung von AWS AppConfig

Im folgenden Beispiel für update-extension wird ein zusätzlicher Parameterschlüssel zu einer Erweiterung in AWS AppConfig hinzugefügt.

aws appconfig update-extension \
    --region us-west-2 \
    --extension-identifier S3-backup-extension \
    --parameters S3bucket={Required=true},CampaignID={Required=false}

Ausgabe:

{
    "Id": "1A2B3C4D",
    "Name": "S3-backup-extension",
    "VersionNumber": 1,
    "Arn": "arn:aws:appconfig:us-west-2:123456789012:extension/1A2B3C4D/1",
    "Actions": {
        "PRE_CREATE_HOSTED_CONFIGURATION_VERSION": [
            {
                "Name": "S3backup",
                "Uri": "arn:aws:lambda:us-west-2:123456789012:function:S3backupfunction",
                "RoleArn": "arn:aws:iam::123456789012:role/appconfigextensionrole"
            }
        ]
    },
    "Parameters": {
        "CampaignID": {
            "Required": false
        },
        "S3bucket": {
            "Required": true
        }
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Erweiterungen für AWS AppConfig im Benutzerhandbuch zu AWS AppConfig.

  • API-Details finden Sie unter UpdateExtension in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie validate-configuration verwendet wird.

AWS CLI

So validieren Sie eine Konfiguration

Im folgenden Beispiel für validate-configuration werden die Validatoren in einem Konfigurationsprofil verwendet, um eine Konfiguration zu validieren.

aws appconfig validate-configuration \
    --application-id abc1234 \
    --configuration-profile-id ur8hx2f \
    --configuration-version 1

Mit dem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Schritt 3: Erstellen einer Konfiguration und eines Konfigurationsprofils im Benutzerhandbuch zu AWS AppConfig.