DescribeSyncEcsHostTask - 获取主机名同步任务详情_云解析DNS(DNS)-阿里云帮助中心

调用DescribeSyncEcsHostTask根据域名ID获取主机名同步任务详情。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

pvtz:DescribeSyncEcsHostTask

get

*Zone

acs:pvtz::{#accountId}:zone/{#ZoneId}

无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	返回值语言，取值： zh：中文。 en：英文。默认值：en	en
ZoneId	string	是	Zone ID，Zone 的唯一识别码。	pvtz-test-id-2989149d628c5****

返回参数

名称	类型	描述	示例值
	object
Status	string	主机名自动同步开关。取值： ON：开启（开启后，每隔 1 分钟，系统自动读取所选 Region 内的 ECS 主机名信息，并更新 DNS 记录） OFF：关闭	ON
ZoneId	string	Zone ID，Zone 的唯一识别码。	pvtz-test-id-2989149d628c56****
RequestId	string	唯一请求识别码。	75446CC1-FC9A-4595-8D96-089D73D7A63D
EcsRegions	object
EcsRegion	array<object>	已同步的 ECS 地域信息。
	object	地域信息
UserId	integer	地域归属的用户 ID，用于跨账号同步场景。	141339776561****
RegionIds	object
RegionId	array	已同步的地域 ID 列表。
	string	已同步的地域 ID。	cn-beijing
Regions	object
RegionId	array	已同步的 ECS 地域 Id。
	string	已同步的地域 ID。	cn-hongkong
Success	boolean	获取主机名同步任务详情是否成功。 True False	True

示例

正常返回示例

JSON格式

{
  "Status": "ON",
  "ZoneId": "pvtz-test-id-2989149d628c56****",
  "RequestId": "75446CC1-FC9A-4595-8D96-089D73D7A63D",
  "EcsRegions": {
    "EcsRegion": [
      {
        "UserId": 0,
        "RegionIds": {
          "RegionId": [
            "cn-beijing"
          ]
        }
      }
    ]
  },
  "Regions": {
    "RegionId": [
      "cn-hongkong"
    ]
  },
  "Success": true
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。