跳到主要内容

HTTP Service

废弃

自 v5.0.0 起此模块已废弃。请迁移至自定义域名与访问路由，新接口语义更清晰，支持完整的域名管理与路由规则配置。

HTTP Service 是云开发为开发者提供的 HTTP 网关，让开发者可以通过 HTTP 访问到自己的云开发资源。

HTTP Service 的接口，可通过 commonService 来调用

创建云函数 HTTPService​

1. 接口描述​

接口功能：创建云函数 HTTPService

接口声明：manager.commonService().call({ Action: 'CreateCloudBaseGWAPI', Param: {}}): Promise<Object>

⚠️ 本接口从 3.0.0 版本后，commonService 作为方法使用，请求参数为(service?:string, version?:string) ，属于不兼容变更

2. 输入参数​

字段必填类型说明
Action是String接口名称
Param是Object接口参数

Param 字段说明​

字段必填类型说明
ServiceId是StringService ID，该字段取值为环境 ID
Path是String自定义路径
Type是Numberservice type ，云函数默认为 1
Name是String函数名

3. 返回结果​

字段必填类型说明
RequestId是String请求唯一标识
APIId是StringAPIId

4. 示例代码​

import CloudBase from '@cloudbase/manager-node'

const manager = new CloudBase({
  secretId: 'Your SecretId',
  secretKey: 'Your SecretKey',
  envId: 'Your envId' // 云开发环境ID，可在腾讯云云开发控制台获取
})

async function test() {
  const res = await manager.commonService().call({
    Action: 'CreateCloudBaseGWAPI',
    Param: { ServiceId: envId, Path: '/sum', Type: 1, Name: 'sum' }
  })
  const { APIId } = res
  console.log(APIId)
}

test()

查询云函数 HTTP Service​

1. 接口描述​

接口功能：查询云函数 HTTP Service

接口声明：manager.commonService().call({ Action: 'DescribeCloudBaseGWAPI', Param: {}}): Promise<Object>

⚠️ 本接口从 3.0.0 版本后，commonService 作为方法使用，请求参数为(service?:string, version?:string) ，属于不兼容变更

2. 输入参数​

字段必填类型说明
Action是String接口名称
Param是Object接口参数

Param 字段说明​

字段必填类型说明
ServiceId否StringService ID，该字段取值为环境 ID
Domain否String绑定的域名
Path否String自定义路径
APIId否StringAPIId

ServiceId 与 Domain 至少要设置其中一个字段！

3. 返回结果​

字段必填类型说明
RequestId是String请求唯一标识
APISet是Array<CloudBaseGWAPI>HTTP service 列表

CloudBaseGWAPI

字段必填类型说明
ServiceId是String环境 ID
APIId是StringAPIId
Path是String自定义路径
Type是Numberservice type ，云函数默认为 1
Name是String云函数名
CreateTime是Numberservice 创建时间
EnvId是String环境 ID

4. 示例代码​

import CloudBase from '@cloudbase/manager-node'

const manager = new CloudBase({
  secretId: 'Your SecretId',
  secretKey: 'Your SecretKey',
  envId: 'Your envId' // 云开发环境ID，可在腾讯云云开发控制台获取
})

async function test() {
  const res = await manager.commonService().call({
    Action: 'DescribeCloudBaseGWAPI',
    Param: {
      ServiceId: envId,
      Path: '/sum'
    }
  })
  const { APISet } = res
  for (let api in APISet) {
    console.log(api)
  }
}

test()

删除云函数 HTTP Service​

1. 接口描述​

接口功能：删除云函数 HTTP Service

接口声明：manager.commonService().call({ Action: 'DeleteCloudBaseGWAPI', Param: {}}): Promise<Object>

⚠️ 本接口从 3.0.0 版本后，commonService 作为方法使用，请求参数为(service?:string, version?:string) ，属于不兼容变更

2. 输入参数​

字段必填类型说明
Action是String接口名称
Param是Object接口参数

Param 字段说明​

字段必填类型说明
ServiceId是StringService ID，该字段取值为环境 ID
Path否String自定义路径
APIId否StringAPIId

3. 返回结果​

字段必填类型说明
RequestId是String请求唯一标识
Count是Number被删除的 HTTP Service 个数

4. 示例代码​

import CloudBase from '@cloudbase/manager-node'

const manager = new CloudBase({
  secretId: 'Your SecretId',
  secretKey: 'Your SecretKey',
  envId: 'Your envId' // 云开发环境ID，可在腾讯云云开发控制台获取
})

async function test() {
  const res = await manager.commonService().call({
    Action: 'DeleteCloudBaseGWAPI',
    Param: {
      ServiceId: envId,
      Path: '/sum'
      // APIId: apiId
    }
  })
  console.log(res.Count)
}

test()

绑定 HTTP Service 自定义域名​

1. 接口描述​

接口功能：绑定 HTTP Service 自定义域名

接口声明：manager.commonService().call({ Action: 'BindCloudBaseGWDomain', Param: {}}): Promise<Object>

⚠️ 本接口从 3.0.0 版本后，commonService 作为方法使用，请求参数为(service?:string, version?:string) ，属于不兼容变更

绑定自定义域名时，请务必在您的自定义域名厂商处 配置 CNAME 域名解析

2. 输入参数​

字段必填类型说明
Action是String接口名称
Param是Object接口参数

Param 字段说明​

字段必填类型说明
ServiceId是StringService ID，该字段取值为环境 ID
Domain是String绑定的域名
CertId否String证书 ID

3. 返回结果​

字段必填类型说明
RequestId是String请求唯一标识

4. 示例代码​

import CloudBase from '@cloudbase/manager-node'

const manager = new CloudBase({
  secretId: 'Your SecretId',
  secretKey: 'Your SecretKey',
  envId: 'Your envId' // 云开发环境ID，可在腾讯云云开发控制台获取
})

async function test() {
  await manager.commonService().call({
    Action: 'BindCloudBaseGWDomain',
    Param: {
      ServiceId: envId,
      Domain: 'xxx.xxx.xxx'
    }
  })
}

test()

查询 HTTP Service 域名​

1. 接口描述​

接口功能：查询 HTTP Service 域名

接口声明：manager.commonService().call({ Action: 'DescribeCloudBaseGWService', Param: {}}): Promise<Object>

⚠️ 本接口从 3.0.0 版本后，commonService 作为方法使用，请求参数为(service?:string, version?:string) ，属于不兼容变更

2. 输入参数​

字段必填类型说明
Action是String接口名称
Param是Object接口参数

Param 字段说明​

字段必填类型说明
ServiceId否StringService ID，该字段取值为环境 ID
Domain否String绑定的域名

ServiceId 与 Domain 至少要设置其中一个字段！

3. 返回结果​

字段必填类型说明
RequestId是String请求唯一标识
ServiceSet是Array<CloudBaseGWService>HTTP Service 域名信息

CloudBaseGWService

字段必填类型说明
ServiceId是String请求唯一标识
Domain是StringHTTP Service 域名信息
OpenTime是Numberservice 开启时间
Status是Number绑定状态，1 绑定中；2 绑定失败；3 绑定成功
注意：此字段可能返回 null，表示取不到有效值。

4. 示例代码​

import CloudBase from '@cloudbase/manager-node'

const manager = new CloudBase({
  secretId: 'Your SecretId',
  secretKey: 'Your SecretKey',
  envId: 'Your envId' // 云开发环境ID，可在腾讯云云开发控制台获取
})

async function test() {
  const res = await manager.commonService().call({
    Action: 'DescribeCloudBaseGWService',
    Param: {
      ServiceId: envId
    }
  })
  const { Domain } = res
  console.log(Domain)
}
test()

解绑 HTTP Service 域名​

1. 接口描述​

接口功能：解绑 HTTP Service 域名

接口声明：manager.commonService().call({ Action: 'DeleteCloudBaseGWDomain', Param: {}}): Promise<Object>

⚠️ 本接口从 3.0.0 版本后，commonService 作为方法使用，请求参数为(service?:string, version?:string) ，属于不兼容变更

2. 输入参数​

字段必填类型说明
Action是String接口名称
Param是Object接口参数

Param 字段说明​

字段必填类型说明
ServiceId是StringService ID，该字段取值为环境 ID
Domain是String绑定的域名

3. 返回结果​

字段必填类型说明
RequestId是String请求唯一标识
Count是Number解绑的 HTTP Service 域名个数

4. 示例代码​

import CloudBase from '@cloudbase/manager-node'

const manager = new CloudBase({
  secretId: 'Your SecretId',
  secretKey: 'Your SecretKey',
  envId: 'Your envId' // 云开发环境ID，可在腾讯云云开发控制台获取
})

async function test() {
  const res = await manager.commonService().call({
    Action: 'DeleteCloudBaseGWDomain',
    Param: {
      ServiceId: envId,
      Domain: 'xxx.xxx.xxx'
    }
  })
  console.log(res.Count)
}

test()