证书管理-上传HTTPS证书

请求

方法 请求 URI
POST https://restapi.cdn.azure.cn/subscriptions/{subscriptionId}/https/certificates?apiVersion=1.0

URI参数

参数名 描述
subscriptionId 订阅唯一标识

请求 Headers

请求包头 描述
x-azurecdn-request-date 必填。符合yyyy-MM-dd hh:mm:ss格式的UTC当前请求时间
Authorization 必填。授权头,具体算法见授权请求头计算。
Content-Type 必填为application/json。

请求 Body

{
    "CertificateName": "neoapitestcert2",
    "PublicCertificate": "",
    "PrivateKey": "",
    "Format": ""
}

参数名称 描述
Name HTTPS证书名字
PublicCertificate Base64编码公证书, 格式类似:
-----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
可包含回车换行,建议包含除根证书之外的完整证书链,拼接规则为服务器证书放最前面,中间证书放中间
PrivateKey Base64编码非加密私钥,格式支持PKCS1:
-----BEGIN RSA PRIVATE KEY-----
-----END RSA PRIVATE KEY-----
和PKCS8:
-----BEGIN PRIVATE KEY-----
-----END PRIVATE KEY-----
中间可包含回车换行。
Format 证书格式, 目前仅支持Pem。

响应

响应由状态码,响应 headers以及响应 body组成。

状态码

状态码 描述
200 表明服务器成功接受请求
其他 表示出错的通用回复

响应 Headers

响应包头 描述
X-Correlation-Id 该请求唯一标识,用于追踪请求信息。

响应 Body

请求成功的JSON示例:

{
    "CertificateId": "387ea244-d62b-11ea-8a85-a8146ee84290",
    "CertificateName": "testforcore1234",
    "SubscriptionId": "6d2d99a1-4053-48dc-a09c-c8fa7ab85cea",
    "ClientCertificateId": "5a84d151-e565-4606-b3fe-83a8c6720f90",
    "Format": "Pem",
    "State": "Active",
    "Issuers": [
        "CN=DigiCert SHA2 Secure Server CA",
        "O=DigiCert Inc",
        "C=US"
    ],
    "Subjects": [
        "CN=*.localdev.cdn.azure.cn",
        "O=Shanghai Blue Cloud Technology Co. Ltd",
        "L=Shanghai",
        "C=CN"
    ],
    "SubjectAlternativeNames": null,
    "Thumbprint": "385A121366B2179ACEA0648FC8D22D5973A79E08",
    "SerialNumber": "0432C66F9B204DE55AB197B78FAE54D0",
    "ValidFrom": "2019-01-04T08:00:00+08:00",
    "ValidTo": "2021-01-04T20:00:00+08:00"
}
参数名称 描述
SubscriptionId 订阅唯一标识
CertificateName HTTPS证书名字
CertificateId HTTPS证书唯一标识

请求失败的JSON示例:

{
  "Succeeded": false,
  "ErrorInfo": {
    "Type": "MissingAuthorizationHeader",
    "Message": "Missing authorization header."
  }
}
参数名称 描述
Type 错误类型
  • CredentialInvalid:凭据不合法
  • ParameterMissing:缺少参数
  • ParameterInvalid:参数不合法
  • MissingAuthorizationHeader:缺少Authorization请求头
  • InvalidRequestDateHeader:请求时间不合法
  • MissingRequestDateHeader:缺少请求时间头
  • AuthorizationHeaderExpired:Authorization请求头已失效
  • InvalidAuthorizationHeader:Authorization请求头不合法
  • ApiKeyNotFound:API密钥不存在
  • InvalidApiKey:API密钥不合法
  • WrongSignature:签名不对
  • SubscriptionNotFound:订阅不存在
  • EndpointDoesNotBelongToSubscription:节点不属于订阅
  • EndpointNotInActiveState:节点不处于活跃状态
  • EndpointNotFound:节点不存在
  • MaliciousItemPathDetected:检查到恶意路径
  • PermissionDenied:权限不够
  • RequestThrottled:请求被限流
  • CertificateAndKeyNotMatch:证书和密钥不匹配
  • CertificateAndEndpointNotMatch:证书和节点不匹配
  • SelfSignedCertificate:不支持自签名证书
  • CertificateDoesNotBelongToSubscription:证书不属于改订阅
Message 错误信息