You need to enable JavaScript to run this app.
导航
SyncEcsHost - 同步 ECS 主机名
最近更新时间:2025.05.22 20:14:00首次发布时间:2023.07.19 19:18:22
我的收藏
有用
有用
无用
无用

同步一次 ECS 主机名。

使用说明

请求频率:每秒最多调用 5 次。

请求说明

  • 请求方式:POST
  • 请求地址:https://private-zone.volcengineapi.com/?Action=SyncEcsHost?Version=2022-06-01

调试

请求参数

除了以下参数,您还需要 对请求进行鉴权

参数
类型
是否必填
示例值
描述
Action
String

SyncEcsHost

要执行的操作,取值:SyncEcsHost。

Version
String

2022-06-01

API的版本,取值:2022-06-01。

ZID
Long

1234

标识域名的唯一 ID。您可以通过以下 API 获取:

EcsRegions
Array of Object

需要同步的地域和火山引擎账号。

返回参数

本接口无特有的返回参数。更多信息请见返回结构

请求示例

POST https://private-zone.volcengineapi.com/?Action=SyncEcsHost&Version=2022-06-01

{
  "ZID": 1013,
  "EcsRegions": [
    {
      "Region": "cn-beijing",
      "AccountID": "210xxxx01"
    }
  ]
}
json

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230614140553EC822FFD341E9C19EF59",
        "Action": "SyncEcsHost",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn"
    }
}
json

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
ErrRegionNotSupport

%s of [%s] not supported by private_zone

private_zone不支持[%s]地域的%s

400
ErrParamInvalid

validation fail: params:[%s] , value:[%v]

参数校验失败

400
ErrOperationForbidden

operation forbidden for global zone

全局域名禁止当前操作

400
ErrZoneNotFound

zone not found

未找到域名

400
ErrNoAuthorization

no authorization on the resource

未得到跨账号资源授权

400
ErrAccountNotOrganizationOwner

you're not the administrator of this account's organization

非账号所属组织的管理员

500
ErrInternalServer

server internal error

服务内部错误