GetSite - 查询单个站点信息

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
esa:GetSiteget
*Site
acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

请求参数

名称类型必填描述示例值
SiteIdlong

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

1234567890123

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

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

查询的站点信息。

AccessTypestring

站点接入类型。取值:

  • NS:通过 NS 接入。
  • CNAME:通过 CNAME 接入。
NS
CnameZonestring

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

example.cname.com
Coveragestring

加速区域。取值:

  • domestic:仅中国内地。
  • global:全球。
  • overseas:全球(不包含中国内地)。
domestic
CreateTimestring

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

2023-12-24T02:01:11Z
UpdateTimestring

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

2023-12-24T02:01:11Z
InstanceIdstring

套餐实例 ID。

cas-merge-q6h0bv
NameServerListstring

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

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

套餐名称。

plan-168777532****
PlanSpecNamestring

站点套餐的规格名称。

normal
ResourceGroupIdstring

资源组 ID。

rg-aek26g6i6se****
SiteIdlong

站点 ID。

1234567890123
SiteNamestring

站点名称。

example.com
Statusstring

站点状态。取值:

  • pending:站点待配置。
  • active:站点已激活。
  • offline:站点已下线。
  • moved:站点已被顶替。
pending
Tagsobject

站点标签。

{"tag1":"value1"}
VerifyCodestring

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

verify_d516cb3740f81f0cef77d162edd1****
VanityNSListobject

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

string

单个自定义 NS 名称。

ns1.example.com
VersionManagementboolean

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

true

示例

正常返回示例

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
  }
}

错误码

HTTP status code错误码错误信息描述
400InternalExceptionFailed to call the service. Try again later or contact technical support.调用服务失败,请稍后重试或联系客服咨询详情。

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

变更历史

变更时间变更内容概要操作
2024-09-18OpenAPI 错误码发生变更查看变更详情