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 的更多信息,请参阅以下内容: