# AWS AppConfig Exemplos do usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o AWS AppConfig.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `create-application`
O código de exemplo a seguir mostra como usar `create-application`.
**AWS CLI**
**Para criar uma aplicação**
O exemplo `create-application` a seguir cria uma aplicação no AWS AppConfig.
```
aws appconfig create-application \
--name "example-application" \
--description "An application used for creating an example."
```
Resultado:
```
{
"Description": "An application used for creating an example.",
"Id": "339ohji",
"Name": "example-application"
}
```
Para obter mais informações, consulte [Etapa 1: criar uma aplicação do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-application.html) na *Referência de comandos da AWS CLI*.
### `create-configuration-profile`
O código de exemplo a seguir mostra como usar `create-configuration-profile`.
**AWS CLI**
**Para criar um perfil de configuração**
O exemplo `create-configuration-profile` a seguir cria um perfil de configuração usando uma configuração armazenada no Parameter Store, um recurso do 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"
```
Resultado:
```
{
"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
}
```
Para obter mais informações, consulte [Etapa 3: criar uma configuração e um perfil de configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [CreateConfigurationProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-configuration-profile.html) na *Referência de comandos da AWS CLI*.
### `create-environment`
O código de exemplo a seguir mostra como usar `create-environment`.
**AWS CLI**
**Para criar um ambiente**
O exemplo `create-environment` a seguir cria um ambiente do AWS AppConfig chamado Example-Environment usando a aplicação que você criou usando create-application.
```
aws appconfig create-environment \
--application-id "339ohji" \
--name "Example-Environment"
```
Resultado:
```
{
"ApplicationId": "339ohji",
"Description": null,
"Id": "54j1r29",
"Monitors": null,
"Name": "Example-Environment",
"State": "ReadyForDeployment"
}
```
Para obter mais informações, consulte [Etapa 2: criar um ambiente](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [CreateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-environment.html) na *Referência de comandos da AWS CLI*.
### `create-extension-association`
O código de exemplo a seguir mostra como usar `create-extension-association`.
**AWS CLI**
**Para criar uma associação de extensão**
O exemplo `create-extension-association` a seguir cria uma nova associação de extensão no 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
```
Resultado:
```
{
"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
}
```
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [CreateExtensionAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-extension-association.html) na *Referência de comandos da AWS CLI*.
### `create-extension`
O código de exemplo a seguir mostra como usar `create-extension`.
**AWS CLI**
**Para criar uma extensão**
O exemplo `create-extension` a seguir cria uma nova extensão no 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}
```
Resultado:
```
{
"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
}
}
}
```
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [CreateExtension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-extension.html) na *Referência de comandos da AWS CLI*.
### `create-hosted-configuration-version`
O código de exemplo a seguir mostra como usar `create-hosted-configuration-version`.
**AWS CLI**
**Para criar uma versão de configuração hospedada**
O exemplo `create-hosted-configuration-version` a seguir cria uma configuração no armazenamento de configuração hospedada do AWS AppConfig. O conteúdo da configuração deve primeiro ser convertido em base64.
```
aws appconfig create-hosted-configuration-version \
--application-id "339ohji" \
--configuration-profile-id "ur8hx2f" \
--content eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9 \
--content-type "application/json" \
configuration_version_output_file
```
Conteúdo de `configuration_version_output_file`:
```
{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }
```
Resultado:
```
{
"ApplicationId": "339ohji",
"ConfigurationProfileId": "ur8hx2f",
"VersionNumber": "1",
"ContentType": "application/json"
}
```
Para obter mais informações, consulte [Sobre o armazenamento de configuração hospedado do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-about-hosted-store) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [CreateHostedConfigurationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/create-hosted-configuration-version.html) na *Referência de comandos da AWS CLI*.
### `delete-application`
O código de exemplo a seguir mostra como usar `delete-application`.
**AWS CLI**
**Como excluir uma aplicação do**
O exemplo `delete-application` a seguir exclui a aplicação especificada.
```
aws appconfig delete-application \
--application-id 339ohji
```
Este comando não produz saída.
Para obter mais informações, consulte [Etapa 1: criar uma aplicação do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-application.html) na *Referência de comandos da AWS CLI*.
### `delete-configuration-profile`
O código de exemplo a seguir mostra como usar `delete-configuration-profile`.
**AWS CLI**
**Para excluir um perfil de configuração**
O exemplo `delete-configuration-profile` a seguir exclui o perfil de configuração especificado.
```
aws appconfig delete-configuration-profile \
--application-id 339ohji \
--configuration-profile-id ur8hx2f
```
Este comando não produz saída.
Para obter mais informações, consulte [Etapa 3: criar uma configuração e um perfil de configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [DeleteConfigurationProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-configuration-profile.html) na *Referência de comandos da AWS CLI*.
### `delete-deployment-strategy`
O código de exemplo a seguir mostra como usar `delete-deployment-strategy`.
**AWS CLI**
**Para excluir uma estratégia de implantação**
O exemplo `delete-deployment-strategy` a seguir exclui a estratégia de implantação especificada.
```
aws appconfig delete-deployment-strategy \
--deployment-strategy-id 1225qzk
```
Este comando não produz saída.
Para obter mais informações, consulte [Etapa 4: criar uma estratégia de implantação](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) no *Guia do usuário do AWSAppConfig*.
+ Para ver detalhes da API, consulte [DeleteDeploymentStrategy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-deployment-strategy.html) na *Referência de comandos da AWS CLI*.
### `delete-environment`
O código de exemplo a seguir mostra como usar `delete-environment`.
**AWS CLI**
**Para excluir um ambiente**
O exemplo `delete-environment` a seguir exclui o ambiente de aplicações especificado.
```
aws appconfig delete-environment \
--application-id 339ohji \
--environment-id 54j1r29
```
Este comando não produz saída.
Para obter mais informações, consulte [Etapa 2: criar um ambiente](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [DeleteEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-environment.html) na *Referência de comandos da AWS CLI*.
### `delete-extension-association`
O código de exemplo a seguir mostra como usar `delete-extension-association`.
**AWS CLI**
**Para excluir uma associação de extensão**
O exemplo `delete-extension-association` a seguir exclui uma associação de extensão do AWS AppConfig.
```
aws appconfig delete-extension-association \
--region us-west-2 \
--extension-association-id a1b2c3d4
```
Este comando não produz saída.
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [DeleteExtensionAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-extension-association.html) na *Referência de comandos da AWS CLI*.
### `delete-extension`
O código de exemplo a seguir mostra como usar `delete-extension`.
**AWS CLI**
**Para excluir uma extensão**
O exemplo `delete-extension` a seguir exclui uma extensão do AWS AppConfig.
```
aws appconfig delete-extension \
--region us-west-2 \
--extension-identifier S3-backup-extension
```
Este comando não produz saída.
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [DeleteExtension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-extension.html) na *Referência de comandos da AWS CLI*.
### `delete-hosted-configuration-version`
O código de exemplo a seguir mostra como usar `delete-hosted-configuration-version`.
**AWS CLI**
**Para excluir uma versão de configuração hospedada**
O exemplo `delete-hosted-configuration-version` a seguir exclui uma versão de configuração hospedada no armazenamento de configuração hospedada do AWS AppConfig.
```
aws appconfig delete-hosted-configuration-version \
--application-id 339ohji \
--configuration-profile-id ur8hx2f \
--version-number 1
```
Saída: este comando não produz saída.
Para obter mais informações, consulte [Etapa 3: criar uma configuração e um perfil de configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [DeleteHostedConfigurationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/delete-hosted-configuration-version.html) na *Referência de comandos da AWS CLI*.
### `get-application`
O código de exemplo a seguir mostra como usar `get-application`.
**AWS CLI**
**Para listar detalhes de uma aplicação**
O exemplo `get-application` a seguir lista os detalhes da aplicação especificada.
```
aws appconfig get-application \
--application-id 339ohji
```
Resultado:
```
{
"Description": "An application used for creating an example.",
"Id": "339ohji",
"Name": "example-application"
}
```
Para obter mais informações, consulte [Como o AWS AppConfig funciona](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html#learn-more-appconfig-how-it-works) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [GetApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-application.html) na *Referência de comandos da AWS CLI*.
### `get-configuration-profile`
O código de exemplo a seguir mostra como usar `get-configuration-profile`.
**AWS CLI**
**Para recuperar detalhes do perfil de configuração**
O exemplo `get-configuration-profile` a seguir retorna detalhes sobre o perfil de configuração especificado.
```
aws appconfig get-configuration-profile \
--application-id 339ohji \
--configuration-profile-id ur8hx2f
```
Resultado:
```
{
"ApplicationId": "339ohji",
"Id": "ur8hx2f",
"Name": "Example-Configuration-Profile",
"LocationUri": "ssm-parameter://Example-Parameter",
"RetrievalRoleArn": "arn:aws:iam::111122223333:role/Example-App-Config-Role"
}
```
Para obter mais informações, consulte [Etapa 3: criar uma configuração e um perfil de configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [GetConfigurationProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-configuration-profile.html) na *Referência de comandos da AWS CLI*.
### `get-configuration`
O código de exemplo a seguir mostra como usar `get-configuration`.
**AWS CLI**
**Para recuperar detalhes da configuração**
O exemplo `get-configuration` a seguir retorna os detalhes da configuração da aplicação de exemplo. Nas chamadas subsequentes para get-configuration, use o parâmetro `client-configuration-version` para atualizar somente a configuração da sua aplicação se a versão tiver sido alterada. Somente atualizar a configuração quando a versão é alterada evita cobranças excessivas incorridas ao chamar get-configuration.
```
aws appconfig get-configuration \
--application "example-application" \
--environment "Example-Environment" \
--configuration "Example-Configuration-Profile" \
--client-id "test-id" \
configuration-output-file
```
Conteúdo de `configuration-output-file`:
```
{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }
```
Resultado:
```
{
"ConfigurationVersion": "1",
"ContentType": "application/json"
}
```
Para obter mais informações, consulte [Etapa 6: receber a configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-retrieving-the-configuration.html) no *Manual do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [GetConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-configuration.html) na *Referência de comandos da AWS CLI*.
### `get-deployment-strategy`
O código de exemplo a seguir mostra como usar `get-deployment-strategy`.
**AWS CLI**
**Para recuperar detalhes de uma estratégia de implantação**
O exemplo `get-deployment-strategy` a seguir lista os detalhes da estratégia de implantação especificada.
```
aws appconfig get-deployment-strategy \
--deployment-strategy-id 1225qzk
```
Resultado:
```
{
"Id": "1225qzk",
"Name": "Example-Deployment",
"DeploymentDurationInMinutes": 15,
"GrowthType": "LINEAR",
"GrowthFactor": 25.0,
"FinalBakeTimeInMinutes": 0,
"ReplicateTo": "SSM_DOCUMENT"
}
```
Para obter mais informações, consulte [Etapa 4: criar uma estratégia de implantação](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) no *Guia do usuário do AWSAppConfig*.
+ Para ver detalhes da API, consulte [GetDeploymentStrategy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-deployment-strategy.html) na *Referência de comandos da AWS CLI*.
### `get-deployment`
O código de exemplo a seguir mostra como usar `get-deployment`.
**AWS CLI**
**Para recuperar detalhes da implantação**
O exemplo `get-deployment` a seguir lista os detalhes da implantação na aplicação no ambiente e na implantação especificados.
```
aws appconfig get-deployment \
--application-id 339ohji \
--environment-id 54j1r29 \
--deployment-number 1
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Etapa 5: implantar uma configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html) no *Manual do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-deployment.html) na *Referência de comandos da AWS CLI*.
### `get-environment`
O código de exemplo a seguir mostra como usar `get-environment`.
**AWS CLI**
**Para recuperar detalhes do ambiente**
O exemplo `get-environment` a seguir retorna os detalhes e o estado do ambiente especificado.
```
aws appconfig get-environment \
--application-id 339ohji \
--environment-id 54j1r29
```
Resultado:
```
{
"ApplicationId": "339ohji",
"Id": "54j1r29",
"Name": "Example-Environment",
"State": "ReadyForDeployment"
}
```
Para obter mais informações, consulte [Etapa 2: criar um ambiente](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [GetEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-environment.html) na *Referência de comandos da AWS CLI*.
### `get-extension-association`
O código de exemplo a seguir mostra como usar `get-extension-association`.
**AWS CLI**
**Para obter detalhes da associação de extensão**
O exemplo `get-extension-association` a seguir exibe informações sobre uma associação de extensão.
```
aws appconfig get-extension-association \
--region us-west-2 \
--extension-association-id a1b2c3d4
```
Resultado:
```
{
"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
}
```
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [GetExtensionAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-extension-association.html) na *Referência de comandos da AWS CLI*.
### `get-extension`
O código de exemplo a seguir mostra como usar `get-extension`.
**AWS CLI**
**Para obter detalhes da extensão**
O exemplo `get-extension` a seguir exibe informações sobre uma extensão.
```
aws appconfig get-extension \
--region us-west-2 \
--extension-identifier S3-backup-extension
```
Resultado:
```
{
"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
}
}
}
```
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [GetExtension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-extension.html) na *Referência de comandos da AWS CLI*.
### `get-hosted-configuration-version`
O código de exemplo a seguir mostra como usar `get-hosted-configuration-version`.
**AWS CLI**
**Como recuperar detalhes da configuração hospedada**
O exemplo `get-hosted-configuration-version` a seguir recupera os detalhes da configuração hospedada do AWS AppConfig.
```
aws appconfig get-hosted-configuration-version \
--application-id 339ohji \
--configuration-profile-id ur8hx2f \
--version-number 1 \
hosted-configuration-version-output
```
Conteúdo de `hosted-configuration-version-output`:
```
{ "Name": "ExampleApplication", "Id": ExampleID, "Rank": 7 }
```
Resultado:
```
{
"ApplicationId": "339ohji",
"ConfigurationProfileId": "ur8hx2f",
"VersionNumber": "1",
"ContentType": "application/json"
}
```
Para obter mais informações, consulte [Sobre o armazenamento de configuração hospedado do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-about-hosted-store) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [GetHostedConfigurationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/get-hosted-configuration-version.html) na *Referência de comandos da AWS CLI*.
### `list-applications`
O código de exemplo a seguir mostra como usar `list-applications`.
**AWS CLI**
**Para listar as aplicações disponíveis**
O exemplo `list-applications` a seguir lista as aplicações disponíveis em sua conta da AWS.
```
aws appconfig list-applications
```
Resultado:
```
{
"Items": [
{
"Id": "339ohji",
"Name": "test-application",
"Description": "An application used for creating an example."
},
{
"Id": "rwalwu7",
"Name": "Test-Application"
}
]
}
```
Para obter mais informações, consulte [Etapa 1: criar uma aplicação do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [ListApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-applications.html) na *Referência de comandos da AWS CLI*.
### `list-configuration-profiles`
O código de exemplo a seguir mostra como usar `list-configuration-profiles`.
**AWS CLI**
**Para listar os perfis de configuração disponíveis**
O exemplo `list-configuration-profiles` a seguir lista os perfis de configuração disponíveis para a aplicação especificada.
```
aws appconfig list-configuration-profiles \
--application-id 339ohji
```
Resultado:
```
{
"Items": [
{
"ApplicationId": "339ohji",
"Id": "ur8hx2f",
"Name": "Example-Configuration-Profile",
"LocationUri": "ssm-parameter://Example-Parameter"
}
]
}
```
Para obter mais informações, consulte [Etapa 3: criar uma configuração e um perfil de configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [ListConfigurationProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-configuration-profiles.html) na *Referência de comandos da AWS CLI*.
### `list-deployment-strategies`
O código de exemplo a seguir mostra como usar `list-deployment-strategies`.
**AWS CLI**
**Para listar as estratégias de implantação disponíveis**
O exemplo `list-deployment-strategies` a seguir lista as estratégias de implantação disponíveis em sua conta da AWS.
```
aws appconfig list-deployment-strategies
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Etapa 4: criar uma estratégia de implantação](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) no *Guia do usuário do AWSAppConfig*.
+ Para ver detalhes da API, consulte [ListDeploymentStrategies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-deployment-strategies.html) na *Referência de comandos da AWS CLI*.
### `list-deployments`
O código de exemplo a seguir mostra como usar `list-deployments`.
**AWS CLI**
**Para listar as implantações disponíveis**
O exemplo `list-deployments` a seguir lista as implantações disponíveis em sua conta da AWS para a aplicação e o ambiente especificados.
```
aws appconfig list-deployments \
--application-id 339ohji \
--environment-id 54j1r29
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Etapa 5: implantar uma configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html) no *Manual do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-deployments.html) na *Referência de comandos da AWS CLI*.
### `list-environments`
O código de exemplo a seguir mostra como usar `list-environments`.
**AWS CLI**
**Para listar os ambientes disponíveis**
O exemplo `list-environments` a seguir lista os ambientes disponíveis em sua conta da AWS para a aplicação especificada.
```
aws appconfig list-environments \
--application-id 339ohji
```
Resultado:
```
{
"Items": [
{
"ApplicationId": "339ohji",
"Id": "54j1r29",
"Name": "Example-Environment",
"State": "ReadyForDeployment"
}
]
}
```
Para obter mais informações, consulte [Etapa 2: criar um ambiente](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [ListEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-environments.html) na *Referência de comandos da AWS CLI*.
### `list-extension-associations`
O código de exemplo a seguir mostra como usar `list-extension-associations`.
**AWS CLI**
**Para listar todas as associações de extensão do AWS AppConfig em sua conta da AWS para uma região da AWS**
O exemplo `list-extension-associations` a seguir lista todas as associações de extensão do AWS AppConfig para a conta da AWS atual em uma região da AWS específica.
```
aws appconfig list-extension-associations \
--region us-west-2
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [ListExtensionAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-extension-associations.html) na *Referência de comandos da AWS CLI*.
### `list-extensions`
O código de exemplo a seguir mostra como usar `list-extensions`.
**AWS CLI**
**Para listar todas as extensões do AWS AppConfig em sua conta da AWS para uma região da AWS**
O exemplo `list-extensions` a seguir lista todas as extensões do AWS AppConfig para a conta da AWS atual em uma região da AWS específica. O comando retorna extensões personalizadas e criadas pela AWS.
```
aws appconfig list-extensions \
--region us-west-2
```
Resultado:
```
{
"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."
}
]
}
```
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [ListExtensions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-extensions.html) na *Referência de comandos da AWS CLI*.
### `list-hosted-configuration-versions`
O código de exemplo a seguir mostra como usar `list-hosted-configuration-versions`.
**AWS CLI**
**Para listar as versões de configuração hospedada disponíveis**
O exemplo `list-hosted-configuration-versions` a seguir lista as versões de configurações hospedadas no armazenamento de configuração hospedada do AWS AppConfig para a aplicação e o perfil de configuração especificados.
```
aws appconfig list-hosted-configuration-versions \
--application-id 339ohji \
--configuration-profile-id ur8hx2f
```
Resultado:
```
{
"Items": [
{
"ApplicationId": "339ohji",
"ConfigurationProfileId": "ur8hx2f",
"VersionNumber": 1,
"ContentType": "application/json"
}
]
}
```
Para obter mais informações, consulte [Sobre o armazenamento de configuração hospedado do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-about-hosted-store) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [ListHostedConfigurationVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-hosted-configuration-versions.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Para listar as tags de uma aplicação**
O exemplo `list-tags-for-resource` a seguir lista as tags de uma aplicação especificada.
```
aws appconfig list-tags-for-resource \
--resource-arn arn:aws:appconfig:us-east-1:682428703967:application/339ohji
```
Resultado:
```
{
"Tags": {
"group1": "1"
}
}
```
Para obter mais informações, consulte [Etapa 1: criar uma aplicação do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) no *Guia do usuário do AWS AppConfig*.
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `start-deployment`
O código de exemplo a seguir mostra como usar `start-deployment`.
**AWS CLI**
**Para iniciar uma implantação de configuração**
O exemplo `start-deployment` a seguir inicia uma implantação na aplicação usando o ambiente, a estratégia de implantação e o perfil de configuração especificados.
```
aws appconfig start-deployment \
--application-id 339ohji \
--environment-id 54j1r29 \
--deployment-strategy-id 1225qzk \
--configuration-profile-id ur8hx2f \
--configuration-version 1
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Etapa 5: implantar uma configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html) no *Manual do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [StartDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/start-deployment.html) na *Referência de comandos da AWS CLI*.
### `stop-deployment`
O código de exemplo a seguir mostra como usar `stop-deployment`.
**AWS CLI**
**Como interromper a implantação da configuração**
O exemplo `stop-deployment` a seguir interrompe a implantação de uma configuração da aplicação no ambiente especificado.
```
aws appconfig stop-deployment \
--application-id 339ohji \
--environment-id 54j1r29 \
--deployment-number 2
```
Resultado:
```
{
"DeploymentNumber": 0,
"DeploymentDurationInMinutes": 0,
"GrowthFactor": 0.0,
"FinalBakeTimeInMinutes": 0,
"PercentageComplete": 0.0
}
```
Para obter mais informações, consulte [Etapa 5: implantar uma configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html) no *Manual do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [StopDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/stop-deployment.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Como marcar uma aplicação**
O exemplo `tag-resource` a seguir adiciona uma tag a um recurso da aplicação.
```
aws appconfig tag-resource \
--resource-arn arn:aws:appconfig:us-east-1:682428703967:application/339ohji \
--tags '{"group1" : "1"}'
```
Este comando não produz saída.
Para obter mais informações, consulte [Etapa 1: criar uma aplicação do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) no *Guia do usuário do AWS AppConfig*.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover uma tag de uma aplicação**
O exemplo `untag-resource` a seguir remove a tag group1 da aplicação especificada.
```
aws appconfig untag-resource \
--resource-arn arn:aws:appconfig:us-east-1:111122223333:application/339ohji \
--tag-keys '["group1"]'
```
Este comando não produz saída.
Para obter mais informações, consulte [Etapa 1: criar uma aplicação do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) no *Guia do usuário do AWS AppConfig*.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/untag-resource.html) na *Referência de comandos da AWS CLI*.
### `update-application`
O código de exemplo a seguir mostra como usar `update-application`.
**AWS CLI**
**Para atualizar uma aplicação**
O exemplo `update-application` a seguir atualiza o nome da aplicação especificada.
```
aws appconfig update-application \
--application-id 339ohji \
--name "Example-Application"
```
Resultado:
```
{
"Id": "339ohji",
"Name": "Example-Application",
"Description": "An application used for creating an example."
}
```
Para obter mais informações, consulte [Etapa 1: criar uma aplicação do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-application.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-application.html) na *Referência de comandos da AWS CLI*.
### `update-configuration-profile`
O código de exemplo a seguir mostra como usar `update-configuration-profile`.
**AWS CLI**
**Para atualizar um perfil de configuração**
O exemplo `update-configuration-profile` a seguir atualiza a descrição do perfil de configuração especificado.
```
aws appconfig update-configuration-profile \
--application-id 339ohji \
--configuration-profile-id ur8hx2f \
--description "Configuration profile used for examples."
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Etapa 3: criar uma configuração e um perfil de configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [UpdateConfigurationProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-configuration-profile.html) na *Referência de comandos da AWS CLI*.
### `update-deployment-strategy`
O código de exemplo a seguir mostra como usar `update-deployment-strategy`.
**AWS CLI**
**Para atualizar uma estratégia de implantação**
O exemplo `update-deployment-strategy` a seguir atualiza o tempo de incorporação final para 20 minutos na estratégia de implantação especificada.
```
aws appconfig update-deployment-strategy \
--deployment-strategy-id 1225qzk \
--final-bake-time-in-minutes 20
```
Resultado:
```
{
"Id": "1225qzk",
"Name": "Example-Deployment",
"DeploymentDurationInMinutes": 15,
"GrowthType": "LINEAR",
"GrowthFactor": 25.0,
"FinalBakeTimeInMinutes": 20,
"ReplicateTo": "SSM_DOCUMENT"
}
```
Para obter mais informações, consulte [Etapa 4: criar uma estratégia de implantação](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-deployment-strategy.html) no *Guia do usuário do AWSAppConfig*.
+ Para ver detalhes da API, consulte [UpdateDeploymentStrategy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-deployment-strategy.html) na *Referência de comandos da AWS CLI*.
### `update-environment`
O código de exemplo a seguir mostra como usar `update-environment`.
**AWS CLI**
**Para atualizar um ambiente**
O exemplo `update-environment` a seguir atualiza a descrição de um ambiente.
```
aws appconfig update-environment \
--application-id 339ohji \
--environment-id 54j1r29 \
--description "An environment for examples."
```
Resultado:
```
{
"ApplicationId": "339ohji",
"Id": "54j1r29",
"Name": "Example-Environment",
"Description": "An environment for examples.",
"State": "RolledBack"
}
```
Para obter mais informações, consulte [Etapa 2: criar um ambiente](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-environment.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [UpdateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-environment.html) na *Referência de comandos da AWS CLI*.
### `update-extension-association`
O código de exemplo a seguir mostra como usar `update-extension-association`.
**AWS CLI**
**Para atualizar uma associação de extensão do AWS AppConfig**
O exemplo `update-extension-association` a seguir adiciona um novo valor de parâmetro a uma associação de extensão no AWS AppConfig.
```
aws appconfig update-extension-association \
--region us-west-2 \
--extension-association-id a1b2c3d4 \
--parameters S3bucket=FinanceMobileApp
```
Resultado:
```
{
"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
}
```
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [UpdateExtensionAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-extension-association.html) na *Referência de comandos da AWS CLI*.
### `update-extension`
O código de exemplo a seguir mostra como usar `update-extension`.
**AWS CLI**
**Para atualizar uma extensão do AWS AppConfig**
O exemplo `update-extension` a seguir adiciona um parâmetro adicional Key a uma extensão no AWS AppConfig.
```
aws appconfig update-extension \
--region us-west-2 \
--extension-identifier S3-backup-extension \
--parameters S3bucket={Required=true},CampaignID={Required=false}
```
Resultado:
```
{
"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
}
}
}
```
Para obter mais informações, consulte [Trabalhar com extensões do AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [UpdateExtension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/update-extension.html) na *Referência de comandos da AWS CLI*.
### `validate-configuration`
O código de exemplo a seguir mostra como usar `validate-configuration`.
**AWS CLI**
**Para validar a configuração**
O exemplo `validate-configuration` a seguir usa os validadores em um perfil de configuração para validar uma configuração.
```
aws appconfig validate-configuration \
--application-id abc1234 \
--configuration-profile-id ur8hx2f \
--configuration-version 1
```
O comando não produz saída.
Para obter mais informações, consulte [Etapa 3: criar uma configuração e um perfil de configuração](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) no *Guia do usuário do AWS AppConfig*.
+ Para ver detalhes da API, consulte [ValidateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appconfig/validate-configuration.html) na *Referência de comandos da AWS CLI*.