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

 

功能介紹

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

URI

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

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

名稱

類型

描述

project_id

String

項目ID

vgw_id

String

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

certificate_id

String

VPN網(wǎng)關(guān)證書ID

請求消息

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

名稱

類型

描述

certificate

VpnGatewayCertificateRequestBodyContent object

VPN網(wǎng)關(guān)證書對象

表3 VpnGatewayCertificateRequestBodyContent

名稱

類型

是否必選

描述

name

String

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

certificate

String

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

private_key

String

  • 功能說明:國密簽名證書私鑰,如果只更新證書名稱可以不傳。
  • 取值范圍:1-4096個字符

certificate_chain

String

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

enc_certificate

String

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

enc_private_key

String

  • 功能說明:國密加密證書私鑰,如果只更新證書名稱可以不傳。
  • 取值范圍:1-4096個字符
  • 請求樣例
    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)證書對象

request_id

String

請求id

表5 VpnGatewayCertificateConfig

名稱

類型

描述

id

String

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

name

String

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

vgw_id

String

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

issuer

String

  • 功能說明:國密簽名證書頒發(fā)者
  • 取值范圍:1-256個字符

signature_algorithm

String

  • 功能說明:國密簽名證書簽名算法
  • 取值范圍:1-64個字符

certificate_serial_number

String

  • 功能說明:國密簽名證書序列號
  • 取值范圍:1-64個字符

certificate_subject

String

  • 功能說明:國密簽名證書使用者
  • 取值范圍:1-256個字符

certificate_expire_time

String

  • 國密簽名證書過期時間

certificate_chain_serial_number

String

  • 功能說明:國密CA證書序列號
  • 取值范圍:1-64個字符

certificate_chain_subject

String

  • 功能說明:國密CA證書使用者
  • 取值范圍:1-256個字符

certificate_chain_expire_time

String

  • 功能說明:國密CA證書過期時間

enc_certificate_serial_number

String

  • 功能說明:國密加密證書序列號
  • 取值范圍:1-64個字符

enc_certificate_subject

String

  • 功能說明:國密加密證書使用者
  • 取值范圍:1-256個字符

enc_certificate_expire_time

String

  • 功能說明:國密加密證書過期時間

created_at

String

  • 功能說明:創(chuàng)建時間
  • 響應(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)碼

請參見狀態(tài)碼