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

# Acesse o depósito de complementos personalizados do Amazon EVS
<a name="addon-depot"></a>

O Amazon EVS fornece um depósito de complementos personalizado que você pode configurar como fonte de download no vSphere Lifecycle Manager (vLCM). Use a ação `GetDepotUrl` da API para recuperar um URL e um token de autenticação para o depósito.

**nota**  
O suporte do console para o depósito de complementos personalizados não está disponível no momento. Use a AWS CLI ou a API.

## Como funciona o depósito de complementos personalizados
<a name="_how_the_custom_addon_depot_works"></a>

Quando você cria um ambiente Amazon EVS, um token de acesso ao depósito é provisionado automaticamente. Você pode usar a ação `GetDepotUrl` da API para recuperar um URL que inclua esse token. Configure esse URL como uma fonte de download no VLcm para sincronizar e instalar o complemento personalizado do Amazon EVS.

**nota**  
O token de acesso ao depósito permanece ativo até ser rotacionado explicitamente usando a bandeira. `--rotate`

## Pré-requisitos
<a name="_prerequisites"></a>

Antes de acessar o depósito de complementos personalizados, você deve ter o seguinte:
+ Um ambiente Amazon EVS no `CREATED` estado.
+ Permissões do IAM para chamar a `evs:GetDepotUrl` ação. Para obter mais informações, consulte [Exemplos de políticas baseadas em identidade do Amazon EVS](security-iam-id-based-policy-examples.md).

## Obtendo um URL de depósito
<a name="_getting_a_depot_url"></a>

Você pode obter um URL de depósito usando a AWS CLI.

### AWS CLI
<a name="shared_aws_cli"></a>

Use o `get-depot-url` comando para recuperar uma URL de depósito para seu ambiente.

```
aws evs get-depot-url --environment-id env-abcde12345
```

A resposta inclui o URL do depósito e o token de autenticação:

```
{
    "depotUrl": "https://example.cloudfront.net/<token>/depot/vmw-depot-index.xml",
    "token": "<authentication-token>"
}
```

## Usando o URL do depósito
<a name="_using_the_depot_url"></a>

Depois de recuperar o URL do depósito, configure-o como uma fonte de download no vSphere Lifecycle Manager (vLCM) para sincronizar e instalar o complemento personalizado do Amazon EVS.

1. Faça login no vSphere Client.

1. Navegue até o vSphere Lifecycle Manager.

1. Adicione o URL do depósito como uma nova fonte de download.

**nota**  
Seu usuário do vSphere deve ter o `VMware vSphere Lifecycle Manager > Configure` privilégio.

Para obter instruções detalhadas sobre como adicionar uma fonte de download, consulte [Adicionar uma nova fonte de download](https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/managing-host-and-cluster-lifecycle/working-with-vsphere-lifecycle-manager-depots/add-a-new-download-source.html) na documentação da Broadcom.

## Girando o token de acesso ao depósito
<a name="_rotating_the_depot_access_token"></a>

Para girar o token de acesso ao depósito, use o `get-depot-url` comando com a `--rotate` bandeira:

```
aws evs get-depot-url --environment-id env-abcde12345 --rotate
```

Após a rotação, os URLs de depósito emitidos anteriormente deixarão de funcionar em 5 minutos. Você deve configurar o novo URL do depósito no VLcm.

## Permissões do IAM
<a name="_iam_permissions"></a>

Para acessar o depósito de complementos personalizados, sua identidade do IAM deve ter permissão para chamar a `evs:GetDepotUrl` ação nos recursos do seu ambiente. Para obter mais informações, consulte [Exemplos de políticas baseadas em identidade do Amazon EVS](security-iam-id-based-policy-examples.md).