A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

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á.

# Adição de componentes da região a um esquema
<a name="region-comp-bp"></a>

O tipo de região pode ser adicionado à interface de `Options` do seu esquema personalizado para gerar um componente no assistente de esquema; é possível inserir uma ou mais regiões da AWS. O tipo de região pode ser importado do seu esquema base em seu arquivo `blueprint.ts`. Para ter mais informações, consulte [Regiões da AWS](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/).

**Para importar Amazon CodeCatalyst blueprints, digite a região**

No arquivo `blueprint.ts`, adicione:

```
import { Region } from '@amazon-codecatalyst/blueprints.blueprint'
```

O parâmetro de tipo de região é uma matriz de códigos de região da AWS para escolher, ou você pode usar `*` para incluir todas as regiões da AWS compatíveis.

**Topics**
+ [Anotações](#region-annotations-bp)
+ [Exemplos de componentes de região](#region-components-examples)

## Anotações
<a name="region-annotations-bp"></a>

JSDoc tags podem ser adicionadas a cada campo na `Options` interface para personalizar como um campo aparece e se comporta no assistente. Para o tipo de região, as seguintes tags são compatíveis:
+ A anotação `@displayName` pode ser usada para alterar o rótulo do campo no assistente.

  Exemplo: `@displayName AWS Region`
+ A anotação `@placeholder` pode ser usada para alterar o espaço reservado do componente de seleção/seleção múltipla.

  Exemplo: `@placeholder Choose AWS Region`

## Exemplos de componentes de região
<a name="region-components-examples"></a>

### Escolha de uma região de uma lista especificada
<a name="region-specified-list-bp"></a>

```
export interface Options extends ParentOptions {
    ...
  /**
   * @displayName Region
   */
  region: Region<['us-east-1', 'us-east-2', 'us-west-1', 'us-west-2']>;
}
```

### Escolha de uma ou mais regiões de uma lista especificada
<a name="region-specified-list-bp"></a>

```
export interface Options extends ParentOptions {
    ...
  /**
   * @displayName Regions
   */
  multiRegion: Region<['us-east-1', 'us-east-2', 'us-west-1', 'us-west-2']>[];
}
```

### Escolha de uma região da AWS
<a name="region-one-bp"></a>

```
export interface Options extends ParentOptions {
    ...
  /**
   * @displayName Region
   */
  region: Region<['*']>;
}
```

### Escolha de uma ou mais regiões de uma lista especificada
<a name="region-specified-list-bp"></a>

```
export interface Options extends ParentOptions {
    ...
  /**
   * @displayName Regions
   */
  multiRegion: Region<['us-east-1', 'us-east-2', 'us-west-1', 'us-west-2']>[];
}
```