華為云計(jì)算 云知識(shí) 導(dǎo)入VPN網(wǎng)關(guān)證書(shū)CreateVgwCertificate
導(dǎo)入VPN網(wǎng)關(guān)證書(shū)CreateVgwCertificate

 

功能介紹

國(guó)密型網(wǎng)關(guān)上傳證書(shū)和私鑰。

URI

POST /v5/{project_id}/vpn-gateways/{vgw_id}/certificate

表1 參數(shù)說(shuō)明

名稱

類型

是否必選

描述

project_id

String

項(xiàng)目ID,可以通過(guò)獲取項(xiàng)目ID獲取項(xiàng)目ID。

vgw_id

String

國(guó)密型網(wǎng)關(guān)ID

請(qǐng)求消息

  • 請(qǐng)求參數(shù)
    表2 VpnGatewayCertificateRequestBody

    名稱

    類型

    是否必選

    描述

    certificate

    VpnGatewayCertificateRequestBodyContent object

    VPN網(wǎng)關(guān)證書(shū)對(duì)象

    表3 VpnGatewayCertificateRequestBodyContent

    名稱

    類型

    是否必選

    描述

    name

    String

    • 功能說(shuō)明:VPN網(wǎng)關(guān)證書(shū)名稱
    • 取值范圍:3-63個(gè)字符、支持?jǐn)?shù)字、英文字母、中文(\u4e00 - \u9fa5)、_(下劃線)、-(中劃線)、.(英文句點(diǎn))。
    • 默認(rèn)值:不填時(shí)會(huì)自動(dòng)生成格式為vpngw-****的名稱。例如:cert-a45b。

    certificate

    String

    • 功能說(shuō)明:簽名證書(shū)
    • 取值范圍:1-4096個(gè)字符

      必須是國(guó)密型非CA證書(shū)。

    private_key

    String

    • 功能說(shuō)明:國(guó)密簽名證書(shū)私鑰
    • 取值范圍:1-4096個(gè)字符

      與簽名證書(shū)的公鑰匹配。

    certificate_chain

    String

    • 功能說(shuō)明:CA證書(shū)內(nèi)容
    • 取值范圍:1-8192個(gè)字符

      必須是國(guó)密型CA證書(shū)。

    enc_certificate

    String

    • 功能說(shuō)明:加密證書(shū)
    • 取值范圍:1-4096個(gè)字符

      必須是國(guó)密型非CA證書(shū)。

    enc_private_key

    String

    • 功能說(shuō)明:國(guó)密加密證書(shū)私鑰
    • 取值范圍:1-4096個(gè)字符

      與加密證書(shū)的公鑰匹配。

    • 請(qǐng)求樣例
      POST https://{Endpoint}/v5/{project_id}/vpn-gateways
      
      {
          "certificate": {
              "name": "cert-dce7",
              "certificate": "-----BEGIN CERTIFICATE-----******-----END CERTIFICATE-----",
              "private_key": "-----BEGIN EC PRIVATE KEY-----*******-----END EC PRIVATE KEY-----",
              "enc_certificate": "-----BEGIN CERTIFICATE-----********-----END CERTIFICATE-----",
              "enc_private_key": "-----BEGIN EC PRIVATE KEY-----********-----END EC PRIVATE KEY-----",
              "certificate_chain": "-----BEGIN CERTIFICATE-----******-----END CERTIFICATE-----"
          }
      }

響應(yīng)消息

  • 響應(yīng)參數(shù)

    返回狀態(tài)碼為 201: successful operation

    表4 響應(yīng)Body參數(shù)列表

    名稱

    類型

    描述

    certificate

    VpnGatewayCertificateConfig object

    VPN網(wǎng)關(guān)證書(shū)對(duì)象

    request_id

    String

    請(qǐng)求ID

    表5 VpnGatewayCertificateConfig

    名稱

    類型

    描述

    id

    String

    • 功能說(shuō)明:VPN網(wǎng)關(guān)證書(shū)ID
    • 格式:36位UUID

    name

    String

    • 功能說(shuō)明:VPN網(wǎng)關(guān)證書(shū)名稱
    • 取值范圍:3-63個(gè)字符、支持?jǐn)?shù)字、英文字母、中文(\u4e00 - \u9fa5)、_(下劃線)、-(中劃線)。

    vgw_id

    String

    • 功能說(shuō)明:VPN網(wǎng)關(guān)ID
    • 格式:36位UUID

    issuer

    String

    • 功能說(shuō)明:國(guó)密簽名證書(shū)頒發(fā)者
    • 取值范圍:1-256個(gè)字符

    signature_algorithm

    String

    • 功能說(shuō)明:國(guó)密簽名證書(shū)簽名算法
    • 取值范圍:1-64個(gè)字符

    certificate_serial_number

    String

    • 功能說(shuō)明:國(guó)密簽名證書(shū)序列號(hào)
    • 取值范圍:1-64個(gè)字符

    certificate_subject

    String

    • 功能說(shuō)明:簽名證書(shū)使用者
    • 取值范圍:1-256個(gè)字符

    certificate_expire_time

    String

    • 功能說(shuō)明:國(guó)密簽名證書(shū)過(guò)期時(shí)間

    certificate_chain_serial_number

    String

    • 功能說(shuō)明:CA證書(shū)序列號(hào)
    • 取值范圍:1-64個(gè)字符

    certificate_chain_subject

    String

    • 功能說(shuō)明:CA證書(shū)使用者
    • 取值范圍:1-256個(gè)字符

    certificate_chain_expire_time

    String

    • 功能說(shuō)明:CA證書(shū)過(guò)期時(shí)間

    enc_certificate_serial_number

    String

    • 功能說(shuō)明:國(guó)密加密證書(shū)序列號(hào)
    • 取值范圍:1-64個(gè)字符

    enc_certificate_subject

    String

    • 功能說(shuō)明:加密證書(shū)使用者
    • 取值范圍:1-256個(gè)字符

    enc_certificate_expire_time

    String

    • 功能說(shuō)明:國(guó)密加密證書(shū)過(guò)期時(shí)間

    created_at

    String

    • 功能說(shuō)明:創(chuàng)建時(shí)間
    • 響應(yīng)樣例
      {
          "certificate": {
              "id": "73f072d8-****-****-****-2a755d95636f",
              "name": "cert-dce7",
              "vgw_id": "c7f1d3e3-0476-4a71-95a7-3ce8cbb969de",
              "issuer": "C=CN,ST=Beijing,L=HaiDian,O=GMCert.org,CN=GMCert GM Root CA - 01",
              "signature_algorithm": "SM3WITHSM2",
              "certificate_serial_number": "16548506527294397241",
              "certificate_subject": "C=CN,ST=beijing,L=beijing,O=huawei,OU=vpn,CN=hwcloud-vpn",
              "certificate_expire_time": "2024-02-20T15:41:39+08:00",
              "certificate_chain_serial_number": "12369133709000538078",
              "certificate_chain_subject": "C=CN,ST=Beijing,L=HaiDian,O=GMCert.org,CN=GMCert GM Root CA - 01",
              "certificate_chain_expire_time": "2039-07-11T20:31:33+08:00",
              "enc_certificate_serial_number": "16548506527294397242",
              "enc_certificate_subject": "C=CN,ST=beijing,L=beijing,O=huawei,OU=vpn,CN=hwcloud-vpn",
              "enc_certificate_expire_time": "2024-02-20T15:43:26+08:00",
              "created_at": "2023-03-30T10:47:16.657+08:00"
          }
      }

狀態(tài)碼

請(qǐng)參見(jiàn)狀態(tài)碼