文档中心

火山方舟

管理推理接入点（Endpoint）

获取接入点推理应用层加密证书

POST https://ark.cn-beijing.volcengineapi.com/?Action=GetEndpointCertificate&Version=2024-01-01

获取指定推理接入点（Endpoint）的应用层加密证书链，用于客户端在调用推理接口前对请求/响应内容进行端到端加解密。证书由火山引擎私有 CA（PCA）签发，包含叶子证书、中间证书与根证书三层。

注意

返回的证书链需配合方舟提供的加密 SDK（MaaS Crypto SDK）使用；证书具备有效期（参见 NotBefore 与 NotAfter），临近过期前需重新调用本接口获取最新证书。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

Access Key 鉴权，请在 Access Key 管理页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数

Body 参数

Id string 必选 | 推理接入点 ID

Type string | 证书类型

响应参数

NotAfter number | 证书过期时间

NotBefore number | 证书生效时间

PCAHost string | 证书签发机构

PCAInstanceCertificate string | 叶子证书（PEM）

PCAName string | 证书产品名称

PCARootCACertificate string | 根证书（PEM）

PCASubCACertificate string | 中间根证书（PEM）

默认

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetEndpointCertificate&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
  "Id": "ep-20240522022935-4pwjK"
}
'

Response

{
  "ResponseMetadata": {
    "RequestId": "2024092515420222213017119486B17C",
    "Action": "GetEndpointCertificate",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "PCAHost": "Volcano Engine PCA",
    "PCAName": "MaaS Crypto SDK Online",
    "PCAInstanceCertificate": "-----BEGIN CERTIFICATE-----\n***\n-----END CERTIFICATE-----\n",
    "PCASubCACertificate": "-----BEGIN CERTIFICATE-----\n***\n-----END CERTIFICATE-----\n",
    "PCARootCACertificate": "-----BEGIN CERTIFICATE-----\n***\n-----END CERTIFICATE-----\n",
    "NotAfter": 1679673599,
    "NotBefore": 1678794684
  }
}

最近更新时间：2026.09.04 20:24:12

这个页面对您有帮助吗？

有用

无用