# 查询API指定版本号 - ShowSpecificVersion #### 功能介绍 查询云监控API指定版本号。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CES/doc?api=ShowSpecificVersion&version=v1)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ces/ces_03_0045.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /{api_version} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | api_version | 是 | String | **参数解释**： API版本号。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | version | [APIVersionResp] object | **参数解释**： 描述 version 相关对象。 **取值范围**： 不涉及。 | 表3APIVersionResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 版本ID（版本号），如v1。 **取值范围**： 不涉及。 | | links | Array of [LinkResp] objects | **参数解释**： API的URL地址。 **取值范围**： 不涉及。 | | version | String | **参数解释**： 若该版本API支持微版本，该参数表示支持的最大微版本号，如果不支持微版本，则为空。 **取值范围**： 不涉及。 | | status | String | **参数解释**： 版本状态。 **取值范围**： 只能为CURRENT、SUPPORTED、DEPRECATED - CURRENT：表示该版本为主推版本。 - SUPPORTED：表示为老版本，但是现在还继续支持。 - DEPRECATED：表示为废弃版本，存在后续删除的可能。 | | updated | String | **参数解释**： 版本发布时间，采用UTC时间表示。如v1发布的时间2014-06-28T12:20:21Z。 **取值范围**： 不涉及。 | | min_version | String | **参数解释**： 若该版本API 支持微版本，该参数表示支持的最小微版本号， 如果不支持微版本，则为空。 **取值范围**： 不涉及。 | 表4LinkResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | href | String | **参数解释**： 当前API版本的引用地址。 **取值范围**： 不涉及。 | | rel | String | **参数解释**： 当前API版本和被引用地址的关系。 **取值范围**： 不涉及。 | #### 请求示例 请求样例 ``` GET https://{云监控的终端节点}/V1.0 ``` #### 响应示例 **状态码：200** 查询成功 ``` { "version" : { "id" : "V1.0", "links" : [ { "href" : "https://x.x.x.x/V1.0/", "rel" : "self" } ], "version" : "", "status" : "CURRENT", "updated" : "2018-09-30T00:00:00Z", "min_version" : "" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功 | | 400 | 请求错误。 | | 401 | 未提供认证信息，或认证信息错误。 | | 403 | 请求页面被禁止访问。 | | 408 | 请求超出了服务器的等待时间。 | | 429 | 当前请求过多。 | | 500 | 请求未完成，服务异常。 | | 503 | 系统暂时不可用，请求受限。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ces/ErrorCode.html)。