View a markdown version of this page

AWS AppConfig esempi di utilizzo AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

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 di utilizzo AWS CLI

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

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare create-application.

AWS CLI

Come 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 la Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare create-configuration-profile.

AWS CLI

Come creare un profilo di configurazione

L’esempio create-configuration-profile seguente crea un profilo di configurazione utilizzando una configurazione archiviata 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 la Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare create-environment.

AWS CLI

Come 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, vedere la Fase 2: Creazione di un ambiente nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare create-extension-association.

AWS CLI

Come creare un’associazione di estensioni

L'create-extension-associationesempio seguente crea una nuova associazione di estensione 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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida AWS AppConfig per l'utente.

L’esempio di codice seguente mostra come utilizzare create-extension.

AWS CLI

Come 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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida AWS AppConfig per l'utente.

L’esempio di codice seguente mostra come utilizzare create-hosted-configuration-version.

AWS CLI

Come creare una versione della configurazione ospitata

L'create-hosted-configuration-versionesempio seguente crea una nuova configurazione nell'archivio di configurazione ospitato. AWS AppConfig 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, vedere Informazioni sull'archivio di configurazione AWS AppConfig ospitato nella Guida per l'utente di AWS Appconfig.

L’esempio di codice seguente mostra come utilizzare delete-application.

AWS CLI

Come eliminare un’applicazione

L’esempio delete-application seguente elimina l’applicazione specificata.

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

Questo comando non produce alcun output.

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

L’esempio di codice seguente mostra come utilizzare delete-configuration-profile.

AWS CLI

Come eliminare un profilo di configurazione

L’esempio delete-configuration-profile 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.

L’esempio di codice seguente mostra come utilizzare delete-deployment-strategy.

AWS CLI

Come eliminare una strategia di implementazione

L’esempio delete-deployment-strategy seguente elimina la strategia di implementazione specificata.

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

Questo comando non produce alcun output.

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

L’esempio di codice seguente mostra come utilizzare delete-environment.

AWS CLI

Come eliminare un ambiente

L’esempio delete-environment seguente elimina l’ambiente dell’applicazione specificato.

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

Questo comando non produce alcun output.

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

L’esempio di codice seguente mostra come utilizzare delete-extension-association.

AWS CLI

Come eliminare un’associazione di estensioni

L'delete-extension-associationesempio seguente elimina un'associazione di estensione 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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare delete-extension.

AWS CLI

Come 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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare delete-hosted-configuration-version.

AWS CLI

Come eliminare una versione della configurazione ospitata

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

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 la Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare get-application.

AWS CLI

Come elencare i dettagli di un’applicazione

L’esempio get-application 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, consulta How AWS AppConfig works nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare get-configuration-profile.

AWS CLI

Come recuperare i dettagli del profilo di configurazione

L’esempio get-configuration-profile 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 la Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare get-configuration.

AWS CLI

Come recuperare i dettagli della configurazione

L’esempio get-configuration seguente restituisce i dettagli della configurazione dell’applicazione di esempio. Nelle chiamate successive a get-configuration, utilizza il parametro client-configuration-version per aggiornare la configurazione dell’applicazione solo se è cambiata la versione. Se la configurazione viene aggiornata solo quando è cambiata la versione, si evitano costi in eccesso derivanti dalle chiamate 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 la Fase 6: Ricezione della configurazione nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare get-deployment-strategy.

AWS CLI

Come recuperare i dettagli di una strategia di implementazione

L’esempio get-deployment-strategy seguente elenca i dettagli della strategia di implementazione 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, consulta la Fase 4: Creazione di una strategia di distribuzione nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare get-deployment.

AWS CLI

Come recuperare i dettagli dell’implementazione

L’esempio get-deployment seguente elenca i dettagli dell’implementazione nell’applicazione nell’ambiente e nell’implementazione 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 la Fase 5: Distribuzione di una configurazione nella Guida per l'utente. AWS AppConfig

  • Per i dettagli sull'API, vedi GetDeployment in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-environment.

AWS CLI

Come recuperare i dettagli dell’ambiente

L’esempio get-environment 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 la Fase 2: Creazione di un ambiente nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare get-extension-association.

AWS CLI

Come ottenere informazioni dettagliate su un’associazione di estensioni

L’esempio get-extension-association 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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare get-extension.

AWS CLI

Come ottenere informazioni dettagliate su un’estensione

L’esempio get-extension 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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida per l'AWS AppConfig utente.

  • Per i dettagli sull'API, vedi GetExtension in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-hosted-configuration-version.

AWS CLI

Per recuperare i dettagli di configurazione ospitati

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

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.

L’esempio di codice seguente mostra come utilizzare list-applications.

AWS CLI

Come 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 la Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare list-configuration-profiles.

AWS CLI

Come elencare i profili di configurazione disponibili

L’esempio list-configuration-profiles 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 la Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare list-deployment-strategies.

AWS CLI

Come elencare le strategie di implementazione disponibili

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

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 la Fase 4: Creazione di una strategia di distribuzione nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare list-deployments.

AWS CLI

Come elencare le implementazioni disponibili

L'list-deploymentsesempio seguente elenca le distribuzioni disponibili nel tuo 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 la Fase 5: Distribuzione di una configurazione nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare list-environments.

AWS CLI

Come elencare gli ambienti disponibili

L'list-environmentsesempio seguente elenca gli ambienti disponibili nel tuo 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 la Fase 2: Creazione di un ambiente nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare list-extension-associations.

AWS CLI

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

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 Utilizzo delle AWS AppConfig estensioni nella Guida AWS AppConfig per l'utente.

L’esempio di codice seguente mostra come utilizzare list-extensions.

AWS CLI

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

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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare list-hosted-configuration-versions.

AWS CLI

Come elencare le versioni delle configurazioni ospitate disponibili

L'list-hosted-configuration-versionsesempio seguente elenca le versioni delle configurazioni ospitate nell'archivio di configurazione ospitato per l'applicazione e il AWS AppConfig 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.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come elencare i tag di un’applicazione

L’esempio list-tags-for-resource seguente elenca i tag dell’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, consulta la Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare start-deployment.

AWS CLI

Come avviare l’implementazione di una configurazione

L’esempio start-deployment seguente avvia un’implementazione nell’applicazione utilizzando l’ambiente, la strategia di implementazione 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 la Fase 5: Distribuzione di una configurazione nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare stop-deployment.

AWS CLI

Come arrestare l’implementazione di una configurazione

L’esempio stop-deployment seguente arresta l’implementazione della configurazione di un’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 la Fase 5: Distribuzione di una configurazione nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come taggare un’applicazione

L’esempio tag-resource seguente tagga 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, consulta la Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida per l'AWS AppConfig utente.

  • Per i dettagli sull'API, vedi TagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere un tag da un’applicazione

L’esempio untag-resource 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, consulta la Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida per l'AWS AppConfig utente.

  • Per i dettagli sull'API, vedi UntagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-application.

AWS CLI

Come aggiornare un’applicazione

L’esempio update-application 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 la Fase 1: Creazione di un' AWS AppConfig applicazione nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare update-configuration-profile.

AWS CLI

Come aggiornare un profilo di configurazione

L’esempio update-configuration-profile 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 la Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare update-deployment-strategy.

AWS CLI

Come aggiornare una strategia di implementazione

L’esempio update-deployment-strategy seguente aggiorna il tempo di incorporamento finale a 20 minuti nella strategia di implementazione 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 la Fase 4: Creazione di una strategia di distribuzione nella Guida per l'utente. AWS AppConfig

L’esempio di codice seguente mostra come utilizzare update-environment.

AWS CLI

Come aggiornare un ambiente

L’esempio update-environment 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, consulta la Fase 2: Creazione di un ambiente nella Guida per l'AWS AppConfig utente.

L’esempio di codice seguente mostra come utilizzare update-extension-association.

AWS CLI

Per aggiornare un'associazione di estensione AWS AppConfig

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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida AWS AppConfig per l'utente.

L’esempio di codice seguente mostra come utilizzare update-extension.

AWS CLI

Per aggiornare un'estensione AWS AppConfig

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, vedere Utilizzo delle AWS AppConfig estensioni nella Guida AWS AppConfig per l'utente.

L’esempio di codice seguente mostra come utilizzare validate-configuration.

AWS CLI

Come convalidare una configurazione

L’esempio validate-configuration 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 la Fase 3: Creazione di una configurazione e di un profilo di configurazione nella Guida per l'AWS AppConfig utente.