View a markdown version of this page

DeleteAgent - AWS DataSync

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

DeleteAgent

Remove um recurso de AWS DataSync agente do seu Conta da AWS.

Lembre-se de que essa operação (que não pode ser desfeita) não remove a máquina virtual (VM) do agente ou a instância do Amazon EC2 do seu ambiente de armazenamento. Nas próximas etapas, você pode excluir a VM ou a instância do seu ambiente de armazenamento ou reutilizá-la para ativar um novo agente.

Sintaxe da solicitação

{ "AgentArn": "string" }

Parâmetros da solicitação

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte Parâmetros comuns.

A solicitação aceita os dados a seguir no formato JSON.

AgentArn

O nome do recurso da Amazon (ARN) do agente a ser excluído. Use a ListAgents operação para retornar uma lista de agentes para sua conta Região da AWS e.

Tipo: string

Restrições de tamanho: tamanho máximo de 128.

Padrão: ^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$

Obrigatório: sim

Elementos de resposta

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

Erros

Para obter informações sobre os erros comuns que todas as ações retornam, consulte Tipos de erro comuns.

InternalException

Essa exceção é lançada quando ocorre um erro no serviço AWS DataSync .

Código de status HTTP: 500

InvalidRequestException

Essa exceção é lançada quando o cliente envia uma solicitação malformada.

Código de Status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: