華為云計(jì)算 云知識(shí) 更新VPN網(wǎng)關(guān)證書(shū)UpdateVgwCertificate
更新VPN網(wǎng)關(guān)證書(shū)UpdateVgwCertificate

 

功能介紹

更新租戶國(guó)密型VPN網(wǎng)關(guān)所使用的證書(shū),包括證書(shū)名稱、簽名證書(shū)、簽名私鑰、加密證書(shū)、加密私鑰和CA證書(shū)鏈。

URI

PUT /v5/{project_id}/vpn-gateways/{vgw_id}/certificate/{certificate_id}

表1 請(qǐng)求path參數(shù)列表

名稱

類型

描述

project_id

String

項(xiàng)目ID

vgw_id

String

VPN網(wǎng)關(guān)實(shí)例ID

certificate_id

String

VPN網(wǎng)關(guān)證書(shū)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))。

certificate

String

  • 功能說(shuō)明:國(guó)密簽名證書(shū)內(nèi)容,如果只更新證書(shū)名稱可以不傳。
  • 取值范圍:1-4096個(gè)字符

private_key

String

  • 功能說(shuō)明:國(guó)密簽名證書(shū)私鑰,如果只更新證書(shū)名稱可以不傳。
  • 取值范圍:1-4096個(gè)字符

certificate_chain

String

  • 功能說(shuō)明:CA證書(shū)內(nèi)容,如果只更新證書(shū)名稱可以不傳。
  • 取值范圍:1-8192個(gè)字符

enc_certificate

String

  • 功能說(shuō)明:國(guó)密加密證書(shū)內(nèi)容,如果只更新證書(shū)名稱可以不傳。
  • 取值范圍:1-4096個(gè)字符

enc_private_key

String

  • 功能說(shuō)明:國(guó)密加密證書(shū)私鑰,如果只更新證書(shū)名稱可以不傳。
  • 取值范圍:1-4096個(gè)字符
  • 請(qǐng)求樣例
    POST https://{Endpoint}/v5/{project_id}/vpn-gateways/{vgw_id}/certificate/{certificate_id}
    
    {
        "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)參數(shù)

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

返回狀態(tài)碼為200: 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ō)明:國(guó)密簽名證書(shū)使用者
  • 取值范圍:1-256個(gè)字符

certificate_expire_time

String

  • 國(guó)密簽名證書(shū)過(guò)期時(shí)間

certificate_chain_serial_number

String

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

certificate_chain_subject

String

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

certificate_chain_expire_time

String

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

enc_certificate_serial_number

String

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

enc_certificate_subject

String

  • 功能說(shuō)明:國(guó)密加密證書(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)碼