

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criando um perfil de configuração de formato livre no AWS AppConfig
<a name="appconfig-free-form-configurations-creating"></a>

*Dados de configuração* são um conjunto de configurações que influenciam o comportamento da aplicação. Um *perfil de configuração* inclui, entre outras coisas, um URI que permite AWS AppConfig localizar seus dados de configuração em seu local armazenado e um tipo de configuração. Com perfis de configuração de formato livre, você pode armazenar seus dados no repositório de configuração AWS AppConfig hospedado ou em qualquer uma das seguintes ferramentas Serviços da AWS e no Systems Manager:


****  

| Local | Tipos de arquivos compatíveis | 
| --- | --- | 
|  AWS AppConfig armazenamento de configuração hospedado  |  YAML, JSON e texto, se adicionados usando o. Console de gerenciamento da AWS Qualquer tipo de arquivo, se adicionado usando a ação AWS AppConfig [CreateHostedConfigurationVersion](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html)da API.  | 
|  [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)  |  Any  | 
|  [AWS CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html)  |  Pipeline (conforme definido pelo serviço)  | 
|  [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)  |  Segredo (conforme definido pelo serviço)  | 
|  [AWS Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html)  |  Parâmetros de string padrão e seguros (conforme definido pelo Parameter Store)  | 
|  [AWS Systems Manager armazenamento de documentos (documentos SSM)](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents.html)  |  YAML, JSON, texto  | 

Um perfil de configuração também pode incluir validadores opcionais para garantir que seus dados de configuração estejam sintática e semanticamente corretos. AWS AppConfig executa uma verificação usando os validadores quando você inicia uma implantação. Se algum erro for detectado, a implantação será interrompida antes de fazer qualquer alteração nos destinos da configuração.

**nota**  
Se possível, recomendamos hospedar seus dados de configuração no armazenamento de configuração AWS AppConfig hospedado, pois ele oferece mais recursos e aprimoramentos.

Para configurações de formato livre armazenadas no repositório de configurações AWS AppConfig hospedado ou nos documentos SSM, você pode criar a configuração de forma livre usando o console do Systems Manager ao criar um perfil de configuração. O processo está descrito posteriormente neste tópico. 

Para configurações de formato livre armazenadas no Parameter Store, Secrets Manager ou Amazon S3, você deve primeiro criar o parâmetro, segredo ou objeto e armazená-lo no respectivo armazenamento de configuração. Depois de armazenar os dados de configuração, use o procedimento neste tópico para criar o perfil de configuração.

**Topics**
+ [

# Noções básicas sobre validadores
](appconfig-creating-configuration-and-profile-validators.md)
+ [

# Noções básicas sobre cotas e limitações do armazenamento de configuração
](appconfig-creating-configuration-and-profile-quotas.md)
+ [

# Entendendo o armazenamento de configuração AWS AppConfig hospedado
](appconfig-creating-configuration-and-profile-about-hosted-store.md)
+ [

# Noções básicas sobre configurações armazenadas no Amazon S3
](appconfig-creating-configuration-and-profile-S3-source.md)
+ [

# Criação de um perfil AWS AppConfig de configuração de formato livre (console)
](appconfig-creating-free-form-configuration-and-profile-create-console.md)
+ [

# Criação de um perfil AWS AppConfig de configuração de formato livre (linha de comando)
](appconfig-creating-free-form-configuration-and-profile-create-commandline.md)

# Noções básicas sobre validadores
<a name="appconfig-creating-configuration-and-profile-validators"></a>

Ao criar um perfil de configuração, é possível especificar até dois validadores. Um validador garante que os dados da configuração estejam sintaticamente e semanticamente corretos. Se você planeja usar um validador, deve criá-lo antes de criar o perfil de configuração. AWS AppConfig suporta os seguintes tipos de validadores:
+ **AWS Lambda funções**: Compatível com sinalizadores de recursos e configurações de formato livre.
+ **Esquema JSON**: compatível com configurações de formato livre. (valida AWS AppConfig automaticamente os sinalizadores de recursos em relação a um esquema JSON.)

**Topics**
+ [

## AWS Lambda validadores de funções
](#appconfig-creating-configuration-and-profile-validators-lambda)
+ [

## Validadores do esquema JSON
](#appconfig-creating-configuration-and-profile-validators-json-schema)

## AWS Lambda validadores de funções
<a name="appconfig-creating-configuration-and-profile-validators-lambda"></a>

O validadores da função do Lambda devem ser configurados com o esquema de eventos a seguir. O AWS AppConfig usa esse esquema para invocar a função do Lambda. O conteúdo é uma string codificada em base64 e o URI é uma string. 

```
{
    "applicationId": "The application ID of the configuration profile being validated", 
    "configurationProfileId": "The ID of the configuration profile being validated",
    "configurationVersion": "The version of the configuration profile being validated",
    "content": "Base64EncodedByteString", 
    "uri": "The configuration uri"    
}
```

AWS AppConfig verifica se o cabeçalho `X-Amz-Function-Error` Lambda está definido na resposta. O Lambda define esse cabeçalho se a função gerar uma exceção. Para obter mais informações sobre `X-Amz-Function-Error`, consulte [Lidar com erros e tentativas automáticas no AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/retries-on-errors.html) no *Guia do desenvolvedor do AWS Lambda *.

Veja um exemplo simples de um código de resposta do Lambda para uma validação bem-sucedida.

```
import json

def handler(event, context):
     #Add your validation logic here
     print("We passed!")
```

Veja um exemplo simples de um código de resposta do Lambda para uma validação malsucedida.

```
def handler(event, context):
     #Add your validation logic here
     raise Exception("Failure!")
```

Veja a seguir outro exemplo que valida somente se o parâmetro de configuração for um número primo.

```
function isPrime(value) {
    if (value < 2) {
        return false;
    }

    for (i = 2; i < value; i++) {
        if (value % i === 0) {
            return false;
        }
    }

    return true;
}

exports.handler = async function(event, context) {
    console.log('EVENT: ' + JSON.stringify(event, null, 2));
    const input = parseInt(Buffer.from(event.content, 'base64').toString('ascii'));
    const prime = isPrime(input);
    console.log('RESULT: ' + input + (prime ? ' is' : ' is not') + ' prime');
    if (!prime) {
        throw input + "is not prime";
    }
}
```

AWS AppConfig chama sua validação de Lambda ao chamar as operações de `ValidateConfigurationActivity` API `StartDeployment` e. Você deve fornecer permissões `appconfig.amazonaws.com` para invocar seu Lambda. Para obter mais informações, consulte [Concedendo acesso de funções aos AWS serviços](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html#permissions-resource-serviceinvoke). AWS AppConfig limita o tempo de execução da validação do Lambda a 15 segundos, incluindo a latência de inicialização.

## Validadores do esquema JSON
<a name="appconfig-creating-configuration-and-profile-validators-json-schema"></a>

Se você criar uma configuração em um documento do SSM, será necessário especificar ou criar um esquema JSON para essa configuração. Um esquema JSON define as propriedades permitidas para cada definição de configuração de aplicativo. O esquema JSON funciona como um conjunto de regras para garantir que definições de configuração novas ou atualizadas estejam em conformidade com as melhores práticas exigidas pelo aplicativo. Aqui está um exemplo. 

```
    {
      "$schema": "http://json-schema.org/draft-04/schema#",
      "title": "$id$",
      "description": "BasicFeatureToggle-1",
      "type": "object",
      "additionalProperties": false,
      "patternProperties": {
          "[^\\s]+$": {
              "type": "boolean"
          }
      },
      "minProperties": 1
    }
```

Quando você cria uma configuração a partir de um documento SSM, o sistema verifica automaticamente se a configuração está em conformidade com os requisitos do esquema. Caso contrário, o AWS AppConfig retornará um erro de validação.

**Importante**  
Observe as seguintes informações importantes sobre validadores do esquema JSON:  
Os dados de configuração armazenados em documentos do SSM devem ser validados em relação a um esquema JSON associado antes que você possa adicionar a configuração ao sistema. Os parâmetros SSM não exigem um método de validação, mas recomendamos que você crie uma verificação de validação para configurações de parâmetros SSM novas ou atualizadas usando. AWS Lambda
Uma configuração em um documento SSM usa o tipo de documento `ApplicationConfiguration`. O esquema JSON correspondente usa o tipo de documento `ApplicationConfigurationSchema`.
AWS AppConfig suporta o esquema JSON versão 4.X para esquema embutido. Se a configuração do seu aplicativo exigir uma versão diferente do esquema JSON, será necessário criar um validador do Lambda.

# Noções básicas sobre cotas e limitações do armazenamento de configuração
<a name="appconfig-creating-configuration-and-profile-quotas"></a>

Os repositórios de configuração suportados pelo AWS AppConfig têm as seguintes cotas e limitações.


****  

|  | AWS AppConfig armazenamento de configuração hospedado | Amazon S3 | Systems Manager Parameter Store | AWS Secrets Manager | Systems Manager Document Store | AWS CodePipeline | 
| --- | --- | --- | --- | --- | --- | --- | 
|  **Limite de tamanho da configuração**  | Padrão de 2 MB, máximo de 4 MB |  2 MB Aplicado por AWS AppConfig, não pelo S3  |  4 KB (nível gratuito) / 8 KB (parâmetros avançados)  | 64 KB |  64 KB  | 2 MBImposta por AWS AppConfig, não CodePipeline | 
|  **Limite de armazenamento de recursos**  | 1 GB |  Ilimitado  |  10.000 parâmetros (nível gratuito) / 100.000 parâmetros (parâmetros avançados)  | 500.000 |  500 documentos  | Limitado pelo número de perfis de configuração por aplicativo (100 perfis por aplicativo) | 
|  **Criptografia do lado do servidor**  | Sim |  [SSE-S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html), [SSE-KMS](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html)  |  Sim  | Sim |  Não  | Sim | 
|  **CloudFormation apoio**  | Sim |  Não é para criar ou atualizar dados  |  Sim  | Sim |  Não  | Sim | 
|  **Preços**  | Gratuito |  Consulte [Definição de preço do Amazon S3](https://aws.amazon.com//s3/pricing/)  |  Consulte [Definição de preço do AWS Systems Manager](https://aws.amazon.com//systems-manager/pricing/)  | Consulte [Definição de preço do AWS Secrets Manager](https://aws.amazon.com//secrets-manager/pricing/) |  Gratuito  |  Consulte [Definição de preço do AWS CodePipeline](https://aws.amazon.com//codepipeline/pricing/)  | 

# Entendendo o armazenamento de configuração AWS AppConfig hospedado
<a name="appconfig-creating-configuration-and-profile-about-hosted-store"></a>

AWS AppConfig inclui um armazenamento de configuração interno ou hospedado. As configurações devem ter 2 MB ou menos. O armazenamento de configuração AWS AppConfig hospedado oferece os seguintes benefícios em relação a outras opções de armazenamento de configuração. 
+ Não é necessário configurar outros serviços, como o Amazon Simple Storage Service (Amazon S3) ou o repositório de parâmetros.
+ Você não precisa configurar permissões AWS Identity and Access Management (IAM) para usar o armazenamento de configurações.
+ É possível armazenar configurações em YAML, JSON ou como documentos de texto.
+ Não há custo para usar o armazenamento.
+ É possível criar uma configuração e adicioná-la ao armazenamento ao criar um perfil de configuração.

# Noções básicas sobre configurações armazenadas no Amazon S3
<a name="appconfig-creating-configuration-and-profile-S3-source"></a>

Você pode armazenar configurações em um bucket do Amazon Simple Storage Service (Amazon S3). Ao criar o perfil de configuração, você especifica o URI para um único objeto do S3 em um bucket. Você também especifica o Amazon Resource Name (ARN) de uma função AWS Identity and Access Management (IAM) que dá AWS AppConfig permissão para obter o objeto. Antes de criar um perfil de configuração para um objeto do Amazon S3, lembre-se das restrições a seguir.


****  

| Restrição | Detalhes | 
| --- | --- | 
|  Tamanho  |  As configurações armazenadas como objetos do S3 podem ter um tamanho máximo de 1 MB.  | 
|  Object encryption  |  Um perfil de configuração pode ter como alvo objetos criptografados SSE-S3 e SSE-KMS.  | 
|  Classes de armazenamento  |  AWS AppConfig suporta as seguintes classes de armazenamento S3: `STANDARD``INTELLIGENT_TIERING`,`REDUCED_REDUNDANCY`,`STANDARD_IA`, e. `ONEZONE_IA` As classes a seguir não são compatíveis: todas as classes do S3 Glacier (`GLACIER` e `DEEP_ARCHIVE`).  | 
|  Versionamento  |  AWS AppConfig exige que o objeto S3 use o controle de versão.  | 

## Configuração de permissões para uma configuração armazenada como um objeto do Amazon S3
<a name="appconfig-creating-configuration-and-profile-S3-source-permissions"></a>

Ao criar um perfil de configuração para uma configuração armazenada como um objeto do S3, você deve especificar um ARN para uma função do IAM que AWS AppConfig dê permissão para obter o objeto. A função deve incluir as seguintes permissões:

Permissões para acessar o objeto do S3
+ s3: GetObject
+ s3: GetObjectVersion

Permissões para listar buckets do S3

s3: ListAllMyBuckets

Permissões para acessar o bucket do S3 em que o objeto está armazenado
+ s3: GetBucketLocation
+ s3: GetBucketVersioning
+ s3: ListBucket
+ s3: ListBucketVersions

Conclua o procedimento a seguir para criar uma função que permita AWS AppConfig obter uma configuração armazenada em um objeto do S3.

**Criação da política do IAM para acessar um objeto do S3**  
Use o procedimento a seguir para criar uma política do IAM que permita AWS AppConfig obter uma configuração armazenada em um objeto do S3.

**Para criar uma política do IAM para acessar um objeto do S3**

1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. No painel de navegação, selecione **Políticas** e, em seguida, **Criar política**.

1. Na página **Criar política**, escolha a guia **JSON**.

1. Atualize a política de exemplo a seguir com informações sobre o bucket do S3 e o objeto de configuração. Depois, cole a política no campo de texto na guia **JSON** . Substitua *placeholder values* por suas próprias informações.

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "s3:GetObject",
           "s3:GetObjectVersion"
         ],
         "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-configurations/my-configuration.json"
       },
       {
         "Effect": "Allow",
         "Action": [
           "s3:GetBucketLocation",
           "s3:GetBucketVersioning",
           "s3:ListBucketVersions",
           "s3:ListBucket"
         ],
         "Resource": [
           "arn:aws:s3:::amzn-s3-demo-bucket"
         ]
       },
       {
         "Effect": "Allow",
         "Action": "s3:ListAllMyBuckets",
         "Resource": "*"
       } 
     ]
   }
   ```

------

1. Selecione **Revisar política**.

1. Na página **Review policy (Revisar política)**, digite um nome na caixa **Name (Nome)** e, depois, uma descrição.

1. Selecione **Criar política**. O sistema faz com que você retorne para a página **Roles**.

**Criação do perfil do IAM para acessar um objeto do S3**  
Use o procedimento a seguir para criar uma função do IAM que permita AWS AppConfig obter uma configuração armazenada em um objeto do S3.

**Para criar um perfil do IAM para acessar um objeto do Amazon S3**

1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. No painel de navegação, escolha **Perfis** e **Criar perfil**.

1. Na seção **Selecionar tipo de entidade confiável**, escolha **Serviço da AWS **.

1. Na seção **Choose a case use (Escolher um caso de uso)** em **Common use cases (Casos de uso comuns)**, escolha **EC2** e, depois, escolha **Next: Permissions (Próximo: Permissões)**.

1. Na página **Attach permissions policy (Anexar política de permissões)**, na caixa de pesquisa, insira o nome da política criada no procedimento anterior. 

1. Selecione essa política e escolha **Next: Tags (Próximo: Tags)**.

1. Na página **Adicionar tags (opcional)**, insira uma chave e um valor opcional e escolha **Próximo: revisão**.

1. Na página **Review (Revisar)**, digite um nome na caixa **Role name (Nome da função)** e, depois, uma descrição.

1. Selecione **Create role** (Criar função). O sistema faz com que você retorne para a página **Roles**.

1. Na página **Roles** (Funções), escolha a função que você acabou de criar para abrir a página **Summary** (Resumo). Anote os valores de **Role Name (Nome da função)** e **Role ARN (ARN da função)**. Você especificará o ARN da função ao criar o perfil de configuração posteriormente neste tópico.

**Criar um relacionamento de confiança**  
Use o procedimento a seguir para configurar a função que você acabou de criar para confiar no AWS AppConfig.

**Como adicionar um relacionamento de confiança**

1. Na página **Summary** da função que você acabou de criar, escolha a guia **Trust Relationships** e, em seguida, **Edit Trust Relationship**.

1. Exclua `"ec2.amazonaws.com"` e adicione `"appconfig.amazonaws.com"`, conforme mostrado no exemplo a seguir.

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "appconfig.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

1. Selecione **Atualizar política de confiança**.

# Criação de um perfil AWS AppConfig de configuração de formato livre (console)
<a name="appconfig-creating-free-form-configuration-and-profile-create-console"></a>

Use o procedimento a seguir para criar um perfil de configuração de AWS AppConfig forma livre e (opcionalmente) uma configuração de forma livre usando o console. AWS Systems Manager 

**Como criar um perfil de configuração de forma livre**

1. Abra o AWS Systems Manager console em [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/).

1. No painel de navegação, escolha **Aplicações** e selecione uma aplicação que você criou em [Criando um namespace para seu aplicativo no AWS AppConfig](appconfig-creating-namespace.md).

1. Selecione a guia **Perfis de configuração e sinalizadores de atributos** e escolha **Criar configuração**.

1. Na seção **Opções de configuração**, escolha **Configuração de forma livre**.

1. Em **ID do perfil de configuração**, insira um nome para o perfil de configuração.

1. (Opcional) Expanda **Descrição** e insira uma descrição.

1. (Opcional) Expanda **Opções adicionais** e conclua o seguinte, conforme necessário.

   1. Na seção **Associar extensões**, selecione uma extensão na lista.

   1. Na seção **Tags**, selecione **Adicionar nova tag** e especifique uma chave e um valor opcional. 

1. Escolha **Próximo**.

1. Na página **Especificar dados de configuração**, na seção **Definição de configuração**, escolha uma opção.

1. Preencha os campos da opção que você selecionou, conforme descrito na tabela a seguir.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/appconfig/latest/userguide/appconfig-creating-free-form-configuration-and-profile-create-console.html)

1. Na seção **Função de serviço**, escolha **Nova função de serviço** para AWS AppConfig criar a função do IAM que fornece acesso aos dados de configuração. AWS AppConfig preenche automaticamente o campo **Nome da função** com base no nome que você inseriu anteriormente. Ou selecione **Perfil de serviço existente**. Escolha a função usando a lista **Role ARN (ARN de função)**.

1. Opcionalmente, na página **Adicionar validadores**, escolha **Esquema JSON** ou **AWS Lambda**. Se você escolher **JSON Schema (Esquema JSON)**, insira o esquema JSON no campo. Se você escolher **AWS Lambda**, escolha o nome de recurso da Amazon (ARN) da função e a versão na lista. 
**Importante**  
Os dados de configuração armazenados em documentos do SSM devem ser validados em relação a um esquema JSON associado antes que você possa adicionar a configuração ao sistema. Os parâmetros SSM não exigem um método de validação, mas recomendamos que você crie uma verificação de validação para configurações de parâmetros SSM novas ou atualizadas usando. AWS Lambda

1. Escolha **Próximo**.

1. Na página **Revisar e salvar**, selecione **Salve continue a implantação**.

**Importante**  
Se você criou um perfil de configuração para AWS CodePipeline, deverá criar um pipeline CodePipeline que especifique AWS AppConfig como o *provedor de implantação*. Você não precisa executar [Implantando sinalizadores de recursos e dados de configuração no AWS AppConfig](deploying-feature-flags.md). No entanto, você deve configurar um cliente para receber atualizações de configuração do aplicativo conforme descrito em [Recuperando dados de configuração sem AWS AppConfig o Agente](about-data-plane.md). Para obter informações sobre a criação de um pipeline que especifica AWS AppConfig como provedor de implantação, consulte [Tutorial: Criar um pipeline usado AWS AppConfig como provedor de implantação](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-AppConfig.html) no *Guia do AWS CodePipeline usuário*. 

Vá para [Implantando sinalizadores de recursos e dados de configuração no AWS AppConfig](deploying-feature-flags.md).

# Criação de um perfil AWS AppConfig de configuração de formato livre (linha de comando)
<a name="appconfig-creating-free-form-configuration-and-profile-create-commandline"></a>

O procedimento a seguir descreve como usar o AWS CLI (no Linux ou no Windows) ou Ferramentas da AWS para PowerShell criar um perfil de configuração de AWS AppConfig formato livre. Se preferir, você pode usar AWS CloudShell para executar os comandos listados abaixo. Para obter mais informações, consulte [O que é o AWS CloudShell?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) no * Guia do usuário do AWS CloudShell *.

**nota**  
Para configurações de formato livre hospedadas no repositório de configurações AWS AppConfig hospedado, você especifica o `hosted` URI de localização.

**Para criar um perfil de configuração usando o AWS CLI**

1. Abra AWS CLI o.

1. Execute o comando a seguir para criar um perfil de configuração de formato livre. 

------
#### [ Linux ]

   ```
   aws appconfig create-configuration-profile \
     --application-id APPLICATION_ID \
     --name NAME \
     --description CONFIGURATION_PROFILE_DESCRIPTION \
     --location-uri CONFIGURATION_URI or hosted \
     --retrieval-role-arn IAM_ROLE_ARN \
     --tags TAGS \
     --validators "Content=SCHEMA_CONTENT or LAMBDA_FUNCTION_ARN,Type=JSON_SCHEMA or LAMBDA"
   ```

------
#### [ Windows ]

   ```
   aws appconfig create-configuration-profile ^
     --application-id APPLICATION_ID ^
     --name NAME ^
     --description CONFIGURATION_PROFILE_DESCRIPTION ^
     --location-uri CONFIGURATION_URI or hosted  ^
     --retrieval-role-arn IAM_ROLE_ARN ^
     --tags TAGS ^
     --validators "Content=SCHEMA_CONTENT or LAMBDA_FUNCTION_ARN,Type=JSON_SCHEMA or LAMBDA"
   ```

------
#### [ PowerShell ]

   ```
   New-APPCConfigurationProfile `
     -Name NAME `
     -ApplicationId APPLICATION_ID `
     -Description CONFIGURATION_PROFILE_DESCRIPTION `
     -LocationUri CONFIGURATION_URI or hosted `
     -RetrievalRoleArn IAM_ROLE_ARN `
     -Tag TAGS `
     -Validators "Content=SCHEMA_CONTENT or LAMBDA_FUNCTION_ARN,Type=JSON_SCHEMA or LAMBDA"
   ```

------

**Importante**  
Observe as seguintes informações importantes:  
Se você criou um perfil de configuração para AWS CodePipeline, deverá criar um pipeline CodePipeline que especifique AWS AppConfig como o *provedor de implantação*. Você não precisa executar [Implantando sinalizadores de recursos e dados de configuração no AWS AppConfig](deploying-feature-flags.md). No entanto, você deve configurar um cliente para receber atualizações de configuração do aplicativo conforme descrito em [Recuperando dados de configuração sem AWS AppConfig o Agente](about-data-plane.md). Para obter informações sobre a criação de um pipeline que especifica AWS AppConfig como provedor de implantação, consulte [Tutorial: Criar um pipeline usado AWS AppConfig como provedor de implantação](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-AppConfig.html) no *Guia do AWS CodePipeline usuário*. 
Se você criou uma configuração no armazenamento de configuração AWS AppConfig hospedado, poderá criar novas versões da configuração usando as operações da [CreateHostedConfigurationVersion](https://docs.aws.amazon.com//appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html)API. Para ver AWS CLI detalhes e exemplos de comandos dessa operação de API, consulte [create-hosted-configuration-version](https://docs.aws.amazon.com/cli/latest/reference/appconfig/create-hosted-configuration-version.html)na *Referência de AWS CLI comandos*.

Vá para [Implantando sinalizadores de recursos e dados de configuração no AWS AppConfig](deploying-feature-flags.md).