全部产品
Search
文档中心

边缘安全加速:GetSite - 查询单个站点信息

更新时间:Jan 15, 2026

根据站点ID查询单个站点信息。

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

esa:GetSite

get

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

请求参数

名称

类型

必填

描述

示例值

SiteId

integer

站点 ID,可通过调用 ListSites 接口获取。

1234567890123

返回参数

名称

类型

描述

示例值

object

请求响应结果。

RequestId

string

请求 ID。

9732E117-8A37-49FD-A36F-ABBB87556CA7

SiteModel

object

查询的站点信息。

AccessType

string

站点接入类型。取值:

  • NS:通过 NS 接入。

  • CNAME:通过 CNAME 接入。

NS

CnameZone

string

站点的 CNAME 后缀。通过 CNAME 方式接入的站点,记录所需要配置 CNAME 的后缀。

example.cname.com

Coverage

string

加速区域。取值:

  • domestic:仅中国内地。

  • global:全球。

  • overseas:全球(不包含中国内地)。

domestic

CreateTime

string

站点的创建时间,日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2023-12-24T02:01:11Z

UpdateTime

string

站点的更新时间,日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2023-12-24T02:01:11Z

InstanceId

string

套餐实例 ID。

cas-merge-q6h0bv

NameServerList

string

站点分配的 NS 列表。使用半角逗号(,)分隔。

male1-1.ialicdn.com,female1-1.ialicdn.com

PlanName

string

套餐名称。

plan-168777532****

PlanSpecName

string

站点套餐的规格名称。

normal

ResourceGroupId

string

资源组 ID。

rg-aek26g6i6se****

SiteId

integer

站点 ID。

1234567890123

SiteName

string

站点名称。

example.com

Status

string

站点状态。取值:

  • pending:站点待配置。

  • active:站点已激活。

  • offline:站点已下线。

  • moved:站点已被顶替。

pending

Tags

object

站点标签。

{"tag1":"value1"}

VerifyCode

string

站点归属校验码。当站点通过 CNAME 接入时,需要配置的 TXT 校验码。

verify_d516cb3740f81f0cef77d162edd1****

VanityNSList

object

站点的自定义 NS 信息,键为单个自定义 NS 名称,值为自定义 NS 对应的 Ip 地址列表,Ip 地址列表用半角逗号(,)分隔。

string

单个自定义 NS 名称。

ns1.example.com

VersionManagement

boolean

版本管理开启状态。为 true 时代表站点开启了版本管理。

true

OfflineReason

string

站点停用原因。取值:

  • expiration_ arrears:订阅套餐到期或账号欠费。

  • internally_disabled:被系统内部停用。

  • missing_icp:域名缺少 ICP。

  • content_violation:内容违规。

  • proactively_disabled:您主动停用或您设置的用量封顶停用。

expiration_ arrears

示例

正常返回示例

JSON格式

{
  "RequestId": "9732E117-8A37-49FD-A36F-ABBB87556CA7",
  "SiteModel": {
    "AccessType": "NS",
    "CnameZone": "example.cname.com",
    "Coverage": "domestic",
    "CreateTime": "2023-12-24T02:01:11Z",
    "UpdateTime": "2023-12-24T02:01:11Z",
    "InstanceId": "cas-merge-q6h0bv",
    "NameServerList": "male1-1.ialicdn.com,female1-1.ialicdn.com",
    "PlanName": "plan-168777532****",
    "PlanSpecName": "normal",
    "ResourceGroupId": "rg-aek26g6i6se****",
    "SiteId": 1234567890123,
    "SiteName": "example.com",
    "Status": "pending",
    "Tags": {
      "tag1": "value1"
    },
    "VerifyCode": "verify_d516cb3740f81f0cef77d162edd1****",
    "VanityNSList": {
      "key": "ns1.example.com"
    },
    "VersionManagement": true,
    "OfflineReason": "expiration_ arrears"
  }
}

错误码

HTTP status code

错误码

错误信息

描述

400 InternalException Failed to call the service. Try again later or contact technical support. 调用服务失败,请稍后重试或联系客服咨询详情。

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

变更历史

更多信息,参考变更详情