DeleteAgent - AWS DataSync

DeleteAgent

从 AWS 账户 中移除 AWS DataSync 代理资源。

请记住,此操作(无法撤消)不会将代理的虚拟机 (VM) 或 Amazon EC2 实例从存储环境中移除。接下来的步骤中,您可以从存储环境中删除 VM 或实例,也可以再次用它来激活一个新代理

请求语法

{ "AgentArn": "string" }

请求参数

有关所有操作的通用参数的信息,请参阅常用参数

请求接受采用 JSON 格式的以下数据。

AgentArn

要删除的代理的 Amazon 资源名称(ARN)。使用 ListAgents 操作以返回账户和 AWS 区域 的代理列表。

类型:字符串

长度限制:最大长度为 128。

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

必需:是

响应元素

如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

错误

有关所有操作的常见错误信息,请参阅 常见错误

InternalException

当 AWS DataSync 服务中发生错误时,会引发此异常。

HTTP 状态代码:500

InvalidRequestException

当客户端提交格式错误的请求时,会引发此异常。

HTTP 状态代码:400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: