AWS AppConfig esempi utilizzando AWS CLI - AWS Command Line Interface
Azioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS AppConfig esempi utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with AWS AppConfig.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Mentre le azioni mostrano come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-application.

AWS CLI

Per creare un'applicazione

L'create-applicationesempio seguente crea un'applicazione in AWS AppConfig.

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

Output:

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

Per ulteriori informazioni, vedere Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarecreate-configuration-profile.

AWS CLI

Per creare un profilo di configurazione

L'create-configuration-profileesempio seguente crea un profilo di configurazione utilizzando una configurazione memorizzata in Parameter Store, una funzionalità di Systems Manager.

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"

Output:

{
    "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
}

Per ulteriori informazioni, vedere Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzarecreate-environment.

AWS CLI

Per creare un ambiente

L'create-environmentesempio seguente crea un AWS AppConfig ambiente denominato Example-Environment utilizzando l'applicazione creata utilizzando create-application.

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

Output:

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

Per ulteriori informazioni, consulta Fase 2: Creazione di un ambiente nella Guida per l'utente.AWS AppConfig

Il seguente esempio di codice mostra come utilizzarecreate-extension-association.

AWS CLI

Per creare un'associazione di estensioni

L'create-extension-associationesempio seguente crea una nuova associazione di estensioni in AWS AppConfig.

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

Output:

{
  "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
}

Per ulteriori informazioni, consultate Lavorare con AWS AppConfig le estensioni nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarecreate-extension.

AWS CLI

Per creare un'estensione

L'create-extensionesempio seguente crea una nuova estensione in AWS AppConfig.

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}

Output:

{
    "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
        }
    }
}

Per ulteriori informazioni, vedete Lavorare con AWS AppConfig le estensioni nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarecreate-hosted-configuration-version.

AWS CLI

Per creare una versione di configurazione ospitata

L'create-hosted-configuration-versionesempio seguente crea una nuova configurazione nell'archivio di configurazione AWS AppConfig ospitato. Il contenuto della configurazione deve essere prima convertito in base64.

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

Contenuto di configuration_version_output_file.

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

Output:

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

Per ulteriori informazioni, consulta Informazioni sull'archivio di configurazione AWS AppConfig ospitato nella Guida per l'utente di AWS Appconfig.

Il seguente esempio di codice mostra come utilizzaredelete-application.

AWS CLI

Eliminazione di un'applicazione

L'delete-applicationesempio seguente elimina l'applicazione specificata.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedere Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzaredelete-configuration-profile.

AWS CLI

Per eliminare un profilo di configurazione

L'delete-configuration-profileesempio seguente elimina il profilo di configurazione specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedere Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzaredelete-deployment-strategy.

AWS CLI

Per eliminare una strategia di distribuzione

L'delete-deployment-strategyesempio seguente elimina la strategia di distribuzione specificata.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedere Fase 4: Creazione di una strategia di distribuzione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzaredelete-environment.

AWS CLI

Per eliminare un ambiente

L'delete-environmentesempio seguente elimina l'ambiente applicativo specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedere Fase 2: Creazione di un ambiente nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzaredelete-extension-association.

AWS CLI

Per eliminare un'associazione di estensioni

L'delete-extension-associationesempio seguente elimina un'associazione di estensioni da AWS AppConfig.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consultate Lavorare con AWS AppConfig le estensioni nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzaredelete-extension.

AWS CLI

Per eliminare un'estensione

L'delete-extensionesempio seguente elimina un'estensione da AWS AppConfig.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedete Lavorare con AWS AppConfig le estensioni nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzaredelete-hosted-configuration-version.

AWS CLI

Per eliminare una versione di configurazione ospitata

L'delete-hosted-configuration-versionesempio seguente elimina una versione di configurazione ospitata nell'archivio di configurazione AWS AppConfig ospitato.

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

Output:: Questo comando non produce alcun output.

Per ulteriori informazioni, vedere Passaggio 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzareget-application.

AWS CLI

Per elencare i dettagli di un'applicazione

L'get-applicationesempio seguente elenca i dettagli dell'applicazione specificata.

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

Output:

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

Per ulteriori informazioni, vedere How AWS AppConfig works in the AWS AppConfig User Guide.

  • Per API i dettagli, vedere GetApplicationin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-configuration-profile.

AWS CLI

Per recuperare i dettagli del profilo di configurazione

L'get-configuration-profileesempio seguente restituisce i dettagli del profilo di configurazione specificato.

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

Output:

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

Per ulteriori informazioni, vedere Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzareget-configuration.

AWS CLI

Per recuperare i dettagli di configurazione

L'get-configurationesempio seguente restituisce i dettagli di configurazione dell'applicazione di esempio. Nelle chiamate successive a get-configuration, utilizzate il client-configuration-version parametro per aggiornare la configurazione dell'applicazione solo se la versione è cambiata. L'aggiornamento della configurazione solo quando la versione è stata modificata evita costi eccessivi dovuti alla chiamata a get-configuration.

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

Contenuto di configuration-output-file.

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

Output:

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

Per ulteriori informazioni, vedere Fase 6: Ricezione della configurazione nella Guida per l'utente.AWS AppConfig

Il seguente esempio di codice mostra come utilizzareget-deployment-strategy.

AWS CLI

Per recuperare i dettagli di una strategia di distribuzione

L'get-deployment-strategyesempio seguente elenca i dettagli della strategia di distribuzione specificata.

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

Output:

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

Per ulteriori informazioni, vedere Fase 4: Creazione di una strategia di distribuzione nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzareget-deployment.

AWS CLI

Per recuperare i dettagli della distribuzione

L'get-deploymentesempio seguente elenca i dettagli della distribuzione nell'applicazione nell'ambiente e nella distribuzione specificati.

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

Output:

{
    "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"
}

Per ulteriori informazioni, vedere Fase 5: Distribuzione di una configurazione nella Guida per l'AWS AppConfig utente.

  • Per API i dettagli, vedere GetDeploymentin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-environment.

AWS CLI

Per recuperare i dettagli dell'ambiente

L'get-environmentesempio seguente restituisce i dettagli e lo stato dell'ambiente specificato.

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

Output:

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

Per ulteriori informazioni, vedere Fase 2: Creazione di un ambiente nella Guida AWS AppConfig per l'utente.

  • Per API i dettagli, vedere GetEnvironmentin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-extension-association.

AWS CLI

Per ottenere i dettagli dell'associazione delle estensioni

L'get-extension-associationesempio seguente visualizza informazioni su un'associazione di estensioni.

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

Output:

{
    "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
}

Per ulteriori informazioni, consultate Lavorare con AWS AppConfig le estensioni nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzareget-extension.

AWS CLI

Per ottenere i dettagli dell'estensione

L'get-extensionesempio seguente visualizza informazioni su un'estensione.

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

Output:

{
    "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
        }
    }
}

Per ulteriori informazioni, consultate Lavorare con AWS AppConfig le estensioni nella Guida AWS AppConfig per l'utente.

  • Per API i dettagli, vedere GetExtensionin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-hosted-configuration-version.

AWS CLI

Per recuperare i dettagli della configurazione ospitata

L'get-hosted-configuration-versionesempio seguente recupera i dettagli di configurazione della configurazione ospitata. AWS AppConfig 

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

Contenuto di hosted-configuration-version-output.

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

Output:

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

Per ulteriori informazioni, vedere Informazioni sull'archivio di configurazione AWS AppConfig ospitato nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzarelist-applications.

AWS CLI

Per elencare le applicazioni disponibili

L'list-applicationsesempio seguente elenca le applicazioni disponibili nel tuo AWS account.

aws appconfig list-applications

Output:

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

Per ulteriori informazioni, vedere Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarelist-configuration-profiles.

AWS CLI

Per elencare i profili di configurazione disponibili

L'list-configuration-profilesesempio seguente elenca i profili di configurazione disponibili per l'applicazione specificata.

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

Output:

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

Per ulteriori informazioni, vedere Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzarelist-deployment-strategies.

AWS CLI

Per elencare le strategie di distribuzione disponibili

L'list-deployment-strategiesesempio seguente elenca le strategie di distribuzione disponibili nel tuo AWS account.

aws appconfig list-deployment-strategies

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Fase 4: Creazione di una strategia di distribuzione nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarelist-deployments.

AWS CLI

Per elencare le distribuzioni disponibili

L'list-deploymentsesempio seguente elenca le distribuzioni disponibili nell' AWS account per l'applicazione e l'ambiente specificati.

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

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, vedere Fase 5: Distribuzione di una configurazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzarelist-environments.

AWS CLI

Per elencare gli ambienti disponibili

L'list-environmentsesempio seguente elenca gli ambienti disponibili nell' AWS account per l'applicazione specificata.

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

Output:

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

Per ulteriori informazioni, vedere Fase 2: Creazione di un ambiente nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarelist-extension-associations.

AWS CLI

Per elencare tutte le associazioni di AWS AppConfig estensioni presenti nel tuo AWS account per una AWS regione

L'list-extension-associationsesempio seguente elenca tutte le associazioni di AWS AppConfig estensione per l' AWS account corrente in una AWS regione specifica.

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

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Lavorare con AWS AppConfig le estensioni nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarelist-extensions.

AWS CLI

Per elencare tutte AWS AppConfig le estensioni presenti nel tuo AWS account per una AWS regione

L'list-extensionsesempio seguente elenca tutte AWS AppConfig le estensioni per l' AWS account corrente in una AWS regione specifica. Il comando restituisce estensioni personalizzate e AWS create.

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

Output:

{
    "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."
        }
    ]
}

Per ulteriori informazioni, consulta Lavorare con AWS AppConfig le estensioni nella Guida per l'AWS AppConfig utente.

  • Per API i dettagli, vedere ListExtensionsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-hosted-configuration-versions.

AWS CLI

Per elencare le versioni di configurazione ospitate disponibili

L'list-hosted-configuration-versionsesempio seguente elenca le versioni delle configurazioni ospitate nell'archivio di configurazione AWS AppConfig ospitato per l'applicazione e il profilo di configurazione specificati.

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

Output:

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

Per ulteriori informazioni, vedere Informazioni sull'archivio di configurazione AWS AppConfig ospitato nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Per elencare i tag di un'applicazione

L'list-tags-for-resourceesempio seguente elenca i tag di un'applicazione specificata.

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

Output:

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

Per ulteriori informazioni, vedere Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarestart-deployment.

AWS CLI

Per avviare una distribuzione della configurazione

L'start-deploymentesempio seguente avvia una distribuzione nell'applicazione utilizzando l'ambiente, la strategia di distribuzione e il profilo di configurazione specificati.

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

Output:

{
    "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"
}

Per ulteriori informazioni, vedere Fase 5: Distribuzione di una configurazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzarestop-deployment.

AWS CLI

Per interrompere la distribuzione della configurazione

L'stop-deploymentesempio seguente interrompe la distribuzione di una configurazione dell'applicazione nell'ambiente specificato.

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

Output:

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

Per ulteriori informazioni, vedere Fase 5: Distribuzione di una configurazione nella Guida per l'AWS AppConfig utente.

  • Per API i dettagli, vedere StopDeploymentin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Per etichettare un'applicazione

L'tag-resourceesempio seguente contrassegna una risorsa dell'applicazione.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedere Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida AWS AppConfig per l'utente.

  • Per API i dettagli, vedere TagResourcein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere un tag da un'applicazione

L'untag-resourceesempio seguente rimuove il tag group1 dall'applicazione specificata.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedere Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida per l'AWS AppConfig utente.

  • Per API i dettagli, vedere UntagResourcein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupdate-application.

AWS CLI

Per aggiornare un'applicazione

L'update-applicationesempio seguente aggiorna il nome dell'applicazione specificata.

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

Output:

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

Per ulteriori informazioni, vedere Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzareupdate-configuration-profile.

AWS CLI

Per aggiornare un profilo di configurazione

L'update-configuration-profileesempio seguente aggiorna la descrizione del profilo di configurazione specificato.

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

Output:

{
    "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"
}

Per ulteriori informazioni, vedere Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.

Il seguente esempio di codice mostra come utilizzareupdate-deployment-strategy.

AWS CLI

Per aggiornare una strategia di distribuzione

L'update-deployment-strategyesempio seguente aggiorna il tempo di cottura finale a 20 minuti nella strategia di distribuzione specificata.

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

Output:

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

Per ulteriori informazioni, consulta Fase 4: Creazione di una strategia di distribuzione nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzareupdate-environment.

AWS CLI

Per aggiornare un ambiente

L'update-environmentesempio seguente aggiorna la descrizione di un ambiente.

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

Output:

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

Per ulteriori informazioni, vedere Fase 2: Creazione di un ambiente nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzareupdate-extension-association.

AWS CLI

Per aggiornare un'associazione di AWS AppConfig estensioni

L'update-extension-associationesempio seguente aggiunge un nuovo valore di parametro a un'associazione di estensione in AWS AppConfig.

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

Output:

{
    "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
}

Per ulteriori informazioni, vedete Lavorare con AWS AppConfig le estensioni nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzareupdate-extension.

AWS CLI

Per aggiornare un' AWS AppConfig estensione

L'update-extensionesempio seguente aggiunge un parametro aggiuntivo Key a un'estensione in AWS AppConfig.

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

Output:

{
    "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
        }
    }
}

Per ulteriori informazioni, consultate Lavorare con AWS AppConfig le estensioni nella Guida AWS AppConfig per l'utente.

Il seguente esempio di codice mostra come utilizzarevalidate-configuration.

AWS CLI

Per convalidare una configurazione

L'validate-configurationesempio seguente utilizza i validatori in un profilo di configurazione per convalidare una configurazione.

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

Il comando non produce alcun output.

Per ulteriori informazioni, vedere Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.