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

# Excluindo um espaço de agente
<a name="deleting-an-agent-space"></a>

Esta página explica como excluir um espaço de AWS DevOps agente do Agente e remover os recursos do IAM que foram criados na sua AWS conta quando você ativou o AWS DevOps Agente. AWS DevOps O agente não fornece uma ação automática de desativação ou desinstalação. Você remove recursos seguindo os procedimentos desta página.

**Importante**  
**A exclusão do espaço do agente remove permanentemente todos os dados da investigação, o histórico do bate-papo, os diários do agente, as recomendações e o gráfico da topologia do aplicativo. A exclusão das funções do IAM remove o acesso do agente à sua AWS conta e o acesso dos usuários ao aplicativo web da operadora. Essas ações não podem ser desfeitas.

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

Antes de começar, verifique se você tem o seguinte:
+ Sign-in acesso ao AWS Management Console como usuário do IAM ou usuário no IAM Identity Center.
+ Permissões para excluir espaços do AWS DevOps agente no serviço do agente (`aidevops:ListAgentSpaces`e`aidevops:DeleteAgentSpace`).
+ Permissões para gerenciar funções e políticas do IAM em sua AWS conta (`iam:ListRoles``iam:ListPolicies`,`iam:ListAttachedRolePolicies`,`iam:DetachRolePolicy`,`iam:DeleteRole`, e`iam:DeletePolicy`).

AWS DevOps O agente é um serviço regional. O espaço do agente e os dados que ele gera são armazenados na AWS região em que você habilitou o agente. Você deve executar o procedimento de exclusão do espaço do agente em cada região em que sua conta tem um espaço do agente. Os recursos do IAM são globais, então você só os exclui uma vez. Para obter a lista de regiões em que o AWS DevOps Agente está disponível, consulte[Regiões aceitas](about-aws-devops-agent-supported-regions.md).

**Importante**  
**Você deve excluir recursos na seguinte ordem. As funções do IAM não podem ser removidas com segurança enquanto o espaço do agente ainda fizer referência a elas.

A tabela a seguir lista os recursos criados quando você ativa o AWS DevOps Agente. Use-o como uma lista de verificação enquanto trabalha nos procedimentos.


| AWS serviço | Tipo de atributo | Nome do recurso | 
| --- | --- | --- | 
| AWS DevOps Agente | Espaço do agente | O nome que você deu ao espaço do agente (padrão:DevOpsAgentSpace) | 
| AWS Identity and Access Management (IAM) | Perfil | AgentSpace função (normalmente chamadaDevOpsAgentRole-AgentSpace-\*) | 
| AWS Identity and Access Management (IAM) | Perfil | WebappAdmin função (normalmente chamadaDevOpsAgentRole-WebappAdmin-\*) | 
| AWS Identity and Access Management (IAM) | Customer-managed política | Qualquer política gerenciada pelo cliente vinculada à função AgentSpace  | 

Os nomes exatos da função e da política dependem do seu caminho de integração. Use os procedimentos da AWS CLI abaixo ou pesquise pelo `DevOpsAgentRole-` prefixo no console do IAM para encontrar os nomes reais em sua conta.

**nota**  
**As duas políticas AWS gerenciadas anexadas às funções do IAM (`AIDevOpsAgentAccessPolicy`e`AIDevOpsOperatorAppAccessPolicy`) são de propriedade AWS e não são excluídas. Você só os separa como parte da exclusão da função.

## Excluir o espaço do agente
<a name="delete-the-agent-space"></a>

A exclusão do espaço do agente remove sua associação de serviços, a configuração do aplicativo do operador e todos os dados de investigação, histórico de bate-papo, diários do agente, recomendações e o gráfico de topologia do aplicativo.

### Usar o AWS DevOps Console do agente
<a name="using-the-aws-devops-agent-console"></a>

1. Abra o console do AWS DevOps agente em [https://console.aws.amazon.com/aidevops/](https://console.aws.amazon.com/aidevops/).

1. Mude sua AWS região para a região em que reside o espaço do agente.

1. No painel de navegação, escolha **Espaços do agente**.

1. Na tabela, selecione o espaço do agente que você deseja remover. A página de **detalhes do espaço do agente** é aberta.

1. Em **Ações**, escolha **Excluir espaço do agente**.

1. Na caixa de diálogo que se abre, revise as informações para verificar se estão corretas, insira o nome do espaço do agente para confirmar e escolha **Excluir**.

### Usar o AWS CLI
<a name="using-the-aws-cli"></a>

**Etapa 1.** Liste os espaços dos agentes em sua região para encontrar seus`agentSpaceId`. Salve o valor da resposta. `REGION`Substitua pela região em que seu espaço de agente reside, por exemplo,`us-east-1`.

```
aws devops-agent list-agent-spaces --region REGION
```

**Etapa 2.** Exclua o espaço do agente. `AGENT_SPACE_ID`Substitua pelo valor da Etapa 1.

```
aws devops-agent delete-agent-space --agent-space-id AGENT_SPACE_ID --region REGION
```

### Verificando se o espaço do agente foi excluído
<a name="verifying-that-the-agent-space-is-deleted"></a>

Execute o comando a seguir e confirme se a resposta contém uma lista vazia.

```
aws devops-agent list-agent-spaces --region REGION
```

## Excluir recursos do IAM
<a name="delete-iam-resources"></a>

Esses procedimentos explicam como remover as funções do IAM e todas as políticas do IAM gerenciadas pelo cliente que foram criadas em sua AWS conta quando você AWS DevOps ativou o Agente. Como os nomes da função e da política dependem do seu caminho de integração, os procedimentos abaixo pesquisam por prefixo no console do IAM ou descobrem seus nomes completos por meio da CLI AWS .

**Importante**  
**Deixar políticas gerenciadas pelo cliente em sua conta é a causa mais comum de falhas na próxima vez que você reativar o AWS DevOps Agente pelo mesmo caminho de integração. Conclua todas as etapas desta seção para evitar problemas se você reativar posteriormente.

### Excluindo o AWS DevOps Funções do Agent IAM (console)
<a name="deleting-the-aws-devops-agent-iam-roles-console"></a>

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

1. Na tabela, pesquise funções com o nome **DevOpsAgentRole**. Duas funções são retornadas, com os nomes do formulário `DevOpsAgentRole-AgentSpace-<suffix>` `DevOpsAgentRole-WebappAdmin-<suffix>` e.

1. Para cada função na tabela, marque a caixa de seleção da função, escolha **Excluir** e, na caixa de diálogo de confirmação, insira o nome da função a ser confirmada e escolha **Excluir**.

### Excluir qualquer política de IAM gerenciada pelo cliente (console)
<a name="deleting-any-customer-managed-iam-policies-console"></a>

Se o seu caminho de integração anexou uma política gerenciada pelo cliente à AgentSpace função, exclua a política depois de excluir a função.

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

1. Filtre por **tipo: gerenciado pelo cliente** e procure todas as políticas cujo nome comece com `AIDevOps` ou qualquer outro identificador que você tenha usado durante a integração.

1. Para cada política que você deseja remover, marque a caixa de seleção da política, escolha **Ações** e escolha **Excluir** no menu suspenso. Na caixa de diálogo que se abre, revise as informações, insira o nome da política a ser confirmada e escolha **Excluir**.

### Usar o AWS CLI
<a name="using-the-aws-cli"></a>

**Etapa 1.** Descubra os nomes das funções criados pela ativação. Salve os nomes das funções das respostas para uso nas etapas a seguir.

```
aws iam list-roles --query "Roles[?starts_with(RoleName, 'DevOpsAgentRole-AgentSpace')].RoleName" --output text
aws iam list-roles --query "Roles[?starts_with(RoleName, 'DevOpsAgentRole-WebappAdmin')].RoleName" --output text
```

**Etapa 2.** Liste as políticas anexadas a cada função. `ROLE_NAME`Substitua por cada nome de função da Etapa 1.

```
aws iam list-attached-role-policies --role-name ROLE_NAME
```

Na resposta, os ARNs da política gerenciada pelo cliente contêm seu ID de AWS conta de 12 dígitos (por exemplo,). `arn:aws:iam::123456789012:policy/...` AWS os ARNs da política gerenciada contêm o literal `aws` (por exemplo,`arn:aws:iam::aws:policy/AIDevOpsAgentAccessPolicy`). Salve os ARNs da política gerenciada pelo cliente para a Etapa 4.

**Etapa 3.** Separe todas as políticas de cada função e, em seguida, exclua a função. Execute o `detach-role-policy` comando uma vez para cada ARN de política retornado pela etapa anterior. `ROLE_NAME`Substitua pelo nome da função e `POLICY_ARN` por cada ARN.

```
aws iam detach-role-policy --role-name ROLE_NAME --policy-arn POLICY_ARN
aws iam delete-role --role-name ROLE_NAME
```

**Etapa 4.** Exclua todas as políticas gerenciadas pelo cliente que você salvou na Etapa 2. `CUSTOMER_POLICY_ARN`Substitua por cada ARN.

```
aws iam delete-policy --policy-arn CUSTOMER_POLICY_ARN
```

### Verificando se os recursos do IAM foram removidos
<a name="verifying-that-the-iam-resources-are-removed"></a>

Execute os seguintes comandos. A primeira chamada deve retornar um resultado vazio. A segunda chamada não deve retornar nenhuma política que você possuía e excluiu.

```
aws iam list-roles --query "Roles[?starts_with(RoleName, 'DevOpsAgentRole-')].RoleName" --output text
aws iam list-policies --scope Local --query "Policies[?starts_with(PolicyName, 'AIDevOps')].PolicyName" --output text
```

## Re-enabling AWS DevOps Agente após a limpeza
<a name="re-enabling-aws-devops-agent-after-cleanup"></a>

Se você removeu os recursos do AWS DevOps Agente seguindo os procedimentos acima e depois quiser habilitar o AWS DevOps Agente novamente, consulte[Começando com o AWS DevOps Agent](getting-started-with-aws-devops-agent.md). Lembre-se do seguinte:
+ Se você não excluiu as políticas do IAM gerenciadas pelo cliente, a próxima tentativa de habilitação por meio do mesmo caminho de integração pode falhar com um erro de função já existente. Exclua primeiro as políticas restantes.
+ Depois de excluir um espaço de agente, o nome é reservado por um curto período. Se você reativar imediatamente e usar o mesmo nome, a criação poderá ser adiada.

## Recursos relacionados
<a name="related-resources"></a>
+ [O que são DevOps Agent Spaces?](about-aws-devops-agent-what-are-devops-agent-spaces.md)
+ [DevOps Permissões do Agent IAM](aws-devops-agent-security-devops-agent-iam-permissions.md)
+ [AWS DevOps Segurança do agente](aws-devops-agent-security.md)
+ [Começando com o AWS DevOps Agent](getting-started-with-aws-devops-agent.md)