# 查询VPN网关证书详情 - QueryGatewayCertificates #### 功能介绍 根据VPN网关ID，查询VPN网关已导入的证书。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-vpn/vpn_api_0008.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpn/vpn_api_0044.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | vpn:vpnGateways:getCertificate | read | vpnGateways | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) | - | - | #### URI GET /v5/{project_id}/vpn-gateways/{vgw_id}/certificate 表1参数说明 | 名称 | 类型 | 描述 | |:---|:---|:---| | project_id | String | 项目id。 | | vgw_id | String | VPN网关实例ID。 | #### 请求消息 - 请求参数 无。 - 请求样例 ``` GET https://{Endpoint}/v5/{project_id}/vpn-gateways/{vgw_id}/certificate ``` #### 响应消息 - 响应参数 返回状态码为 200: 查询成功。 表2响应Body参数列表 | 名称 | 类型 | 描述 | |:---|:---|:---| | certificate | [VpnGatewayCertificate] object | 证书对象。 | | request_id | String | 请求ID。 | 表3VpnGatewayCertificate | 名称 | 类型 | 描述 | |:---|:---|:---| | id | String | - 功能说明：VPN网关证书ID。 - 格式：36位UUID。 | | name | String | - 功能说明：VPN网关证书名称。 - 取值范围：3-63个字符、支持数字、英文字母、中文(\\u4e00 - \\u9fa5)、_(下划线)、-(中划线)、.(英文句点)。 | | project_id | String | - 功能说明：租户的项目ID。 - 取值范围：1-64个字符。 | | vgw_id | String | - 功能说明：VPN网关ID。 - 格式：36位UUID。 | | status | String | - 功能说明：网关证书状态。 - 取值范围： - BOUND：已关联 - FAULT：关联失败 - BINDING：关联中 | | issuer | String | - 功能说明：国密签名证书颁发者。 - 取值范围：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 | - 功能说明：创建时间。 | | updated_at | String | - 功能说明：更新时间。 | - 响应样例 ``` { "certificate": { "id": "18b81966-demo-a8df-va86-51db2ae6cfbd", "name": "cert-ces-test", "project_id": "06057689f680d5762f7fc008c77b8891", "vgw_id": "b1e94931-demo-a8df-va86-ec906c458ba7", "status": "BOUND", "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": "2023-03-21T07:41:39Z", "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": "2023-03-21T01:31:33Z", "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": "2023-03-21T07:43:26Z", "created_at": "2023-03-14T07:48:13.705Z", "updated_at": "2023-03-14T07:48:13.887Z" } } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-vpn/vpn_api_0052.html)。