使用阿里云CLI管理PolarDB MySQL版/PostgreSQL版_云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

本文以调用DescribeClassList接口查看PolarDB可用集群规格列表为例，为您介绍使用阿里云CLI调用PolarDB MySQL版/PostgreSQL版的操作步骤。

前置概念

阅读本文前，建议您先了解什么是阿里云CLI。
暂不支持使用阿里云CLI调用云原生数据库 PolarDB 分布式版2.0（2020版本）OpenAPI。

步骤一：安装阿里云CLI

使用阿里云CLI前，您需要先安装阿里云CLI。阿里云CLI为用户提供了Windows、Linux和macOS三种操作系统下的安装服务，请根据您使用设备的操作系统选择对应的安装服务。

您也可在云命令行（Cloud Shell）中调试阿里云CLI命令。云命令行预装了阿里云CLI，且在使用时自动为您配置身份凭证，无需手动操作。更多信息，请参见什么是云命令行。

步骤二：配置阿里云CLI

重要

阿里云主账号拥有所有产品OpenAPI的管理和访问权限，风险很高。强烈建议您创建RAM身份，并依据最小化权限原则授予权限，使用RAM身份访问OpenAPI。PolarDB MySQL版/PostgreSQL版支持的权限策略，请参见云原生数据库 PolarDB系统权限策略参考及云原生数据库PolarDB自定义权限策略参考。

使用阿里云CLI之前，您需要在阿里云CLI中配置身份凭证、地域ID等信息。阿里云CLI支持多种身份凭证，详情请参见身份凭证类型。本文以AK类型凭证为例，具体操作步骤如下：

创建一个RAM用户，并创建AccessKey，以便后续配置身份凭证使用。具体操作，请参见创建RAM用户及创建AccessKey。
为RAM用户授权。本文示例需授予RAM用户只读访问PolarDB MySQL版/PostgreSQL版的权限策略AliyunPolardbReadOnlyAccess。具体操作，请参见为RAM用户授权。
获取可用的地域ID，以便后续配置身份凭证使用。阿里云CLI将使用您指定的地域发起OpenAPI调用，PolarDB MySQL版/PostgreSQL版的可用地域请参见服务接入点。
说明
使用阿里云CLI过程中您可使用--region选项指定地域发起命令调用，该选项在使用时将忽略默认身份凭证配置及环境变量设置中的地域信息。详情请参见API命令可用选项。
使用RAM用户的AccessKey及地域ID配置AK类型凭证，配置文件命名为AkProfile。具体操作，请参见配置示例。

步骤三：生成CLI命令示例

在OpenAPI门户中，访问DescribeClassList调试地址。
在参数配置中输入请求参数，单击CLI示例页签，查看生成的CLI示例。
复制CLI示例或在云命令行中快速执行：
- 单击运行命令按钮，可唤出云命令行并快速完成命令调试。
- 单击复制按钮，将CLI示例复制到剪贴板中，可粘贴至本地Shell工具中运行。
说明
复制CLI示例到本地Shell工具中进行调试时请注意参数格式。关于阿里云CLI命令参数使用格式的详细信息，请参见参数格式说明。
OpenAPI门户生成示例中会默认添加--region选项，复制命令到本地调用时阿里云CLI将忽略默认身份凭证配置及环境变量设置中的地域信息，优先使用指定的地域调用命令，您可根据需要对该选项进行删除或保留。

步骤四：调用PolarDB MySQL版/PostgreSQL版OpenAPI

示例一：获取支持阿里云CLI调用PolarDB MySQL版/PostgreSQL版OpenAPI列表

以下示例将为您展示如何使用--help选项获取支持阿里云CLI调用的PolarDB MySQL版/PostgreSQL版OpenAPI列表。更多信息，请参见API概览。

执行命令。
```
aliyun polardb --help
```
输出结果。

示例二：获取集群规格列表

以下示例将为您展示如何使用阿里云CLI调用PolarDB MySQL版/PostgreSQL版的DescribeClassList接口，查询PolarDB MySQL版/PostgreSQL版在中国内地可用的包年包月集群规格列表。

说明

如果您使用的是阿里云国内站账号，只能查看国内的商品Code。
如果您使用的是阿里云国际站账号，只能查看国际的商品Code。
如果您使用的是聚石塔账号，只能查看聚石塔的商品Code。
如果您使用的是菜鸟账号，只能查看菜鸟的商品Code。

执行命令。

aliyun polardb DescribeClassList --CommodityCode polardb_sub

输出结果。

{
  "RequestId": "69A85BAF-1089-4CDF-A82F-0A140F******",
  "Items": [
    {
      "Psl4MaxIOPS": "48000",
      "ClassTypeLevel": "enterprise",
      "Cpu": "8",
      "ReferencePrice": "200000",
      "ReferenceExtPrice": "200000",
      "MaxConnections": "8000",
      "MemoryClass": "32",
      "ClassCode": "polar.mysql.x4.medium",
      "ClassGroup": "Exclusive package",
      "Psl5MaxIOPS": "96000",
      "MaxIOPS": "32000",
      "MaxStorageCapacity": "20",
      "Pl1MaxIOPS": "50000",
      "Pl2MaxIOPS": "100000",
      "Pl3MaxIOPS": "1000000"
    }
  ],
  "RegionId": "cn-hangzhou"
}

说明

如果调用PolarDB MySQL版/PostgreSQL版OpenAPI后返回错误，您需要根据返回的错误码提示检查传入的请求参数及其取值是否正确。

您也可以记录下调用返回的RequestID或SDK报错信息，通过阿里云OpenAPI诊断平台进行自助诊断。