CLI集成示例_云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

阿里云CLI（Alibaba Cloud Command Line Interface）是基于OpenAPI构建的通用命令行工具，您可以通过阿里云CLI实现自动化管理和维护云原生数据仓库 AnalyticDB MySQL 版。本文将为您介绍使用阿里云CLI调用云原生数据仓库 AnalyticDB MySQL 版的操作步骤和示例。

前置概念

阅读本文前，若您还不了解阿里云CLI，请参见什么是阿里云CLI。

安装阿里云CLI

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

您也可使用阿里云提供的云命令行Cloud Shell调试阿里云CLI命令。关于云命令行的更多信息，请参考什么是云命令行。

配置阿里云CLI

重要

阿里云账号（主账号）拥有所有产品API的管理和访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。

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

您需要创建一个RAM用户并授予相应操作权限。具体操作，请参见创建RAM用户及为RAM用户授权。
重要
本示例需要您为RAM用户授予AliyunADBFullAccess权限策略，在实际使用时，请根据业务情况按需分配权限后进行接口调用。AnalyticDB for MySQL的权限策略，请参见云原生数据仓库AnalyticDB MySQL版系统权限策略参考。
创建RAM用户并授权后，您需要创建RAM用户对应的AccessKey，并记录AccessKey ID和AccessKey Secret，以便后续配置身份凭证使用。具体操作，请参见创建AccessKey。
您需要获取并记录可用的地域ID，以便后续配置身份凭证使用。阿里云CLI将使用您指定的地域发起API调用。企业版、基础版或湖仓版可用地域请参见服务接入点。
说明
使用阿里云CLI过程中您可使用--region选项指定地域发起命令调用，该选项在使用时将忽略默认身份凭证配置及环境变量设置中的地域信息。详情请参见API命令可用选项。
使用RAM用户的AccessKey配置AK类型凭证，配置文件命名为AkProfile。具体操作，请参见配置示例。

生成CLI命令示例

登录企业版、基础版或湖仓版API调试列表。
在API调试界面左侧搜索框中可搜索您需要使用的API。在参数配置中根据API文档信息填写参数，单击参数配置右侧的CLI示例页签即可生成携带参数的命令示例。
- 单击按钮，可唤出云命令行Cloud Shell并在其中快速完成命令调试。
- 单击按钮，将CLI示例复制到剪贴板中，可粘贴至本地Shell工具中运行。
  - 复制CLI示例到本地Shell工具中进行调试时请注意参数格式。关于阿里云CLI命令参数使用格式的详细信息，请参见参数格式说明。
  - OpenAPI门户生成示例中会默认添加--region选项，复制命令到本地调用时阿里云CLI将忽略默认身份凭证配置及环境变量设置中的地域信息，优先使用指定的地域调用命令，您可根据需要对该选项进行删除或保留。

调用API

命令结构

阿里云CLI的通用命令行结构如下。更多详情，请参见命令结构。

aliyun <command> <subcommand> [options and parameters]

常用命令选项

在阿里云CLI中，您可根据需要使用命令行选项，用来修改命令的默认行为或为命令提供额外功能。常用命令行选项如下：

--profile <profileName>：使用--profile选项并指定有效配置名称profileName后，阿里云CLI将忽略默认身份凭证配置及环境变量设置，优先使用指定的配置进行命令调用。
--help：在需要获取帮助的命令层级处键入--help选项，即可获取该命令的帮助信息。更多详情，请参见获取帮助信息。

更多详细信息，请参见API命令可用选项。

调用示例

以下示例将为您展示如何使用阿里云CLI调用AnalyticDB for MySQL中的DescribeDBClusterAttribute命令，查询指定企业版、基础版或湖仓版集群的信息。DescribeDBClusterAttribute命令的详细介绍，请参见DescribeDBClusterAttribute。

执行命令。

aliyun adb DescribeDBClusterAttribute --region cn-hangzhou --DBClusterId 'amv-bp15yg4o68****' --version 2021-12-01 --method POST --force

输出结果。

{
        "Items": {
                "DBCluster": [
                        {
                                "ClickhouseEngineCacheSize": -1,
                                "ClickhouseEngineEnabled": false,
                                "CommodityCode": "ads",
                                "ComputeResource": "0ACU",
                                "ComputeResourceTotal": "0ACU",
                                "ConnectionString": "amv-bp15yg4o68****.ads.aliyuncs.com",
                                "CreationTime": "2024-09-26T05:25:46Z",
                                "DBClusterDescription": "amv-bp15yg4o68****",
                                "DBClusterId": "amv-bp15yg4o68****",
                                "DBClusterNetworkType": "VPC",
                                "DBClusterStatus": "Running",
                                "DBClusterType": "Common",
                                "DBVersion": "5.0",
                                "Engine": "3.2.2.2",
                                "EngineVersion": "3.2.2.2",
                                "ExpireTime": "",
                                "KmsId": "",
                                "LockMode": "Unlock",
                                "LockReason": "",
                                "MaintainTime": "15:00Z-16:00Z",
                                "Mode": "flexible",
                                "PayType": "Postpaid",
                                "Port": "3306",
                                "ProductForm": "IntegrationForm",
                                "ProductVersion": "EnterpriseVersion",
                                "RegionId": "cn-hangzhou",
                                "ReservedACU": "0ACU",
                                "ReservedNodeCount": 3,
                                "ReservedNodeSize": "8ACU",
                                "ResourceGroupId": "rg-acfmz7u4zzrngoa",
                                "StorageResource": "24ACU",
                                "StorageResourceTotal": "24ACU",
                                "SupportedFeatures": {
                                        "AutoMC": true,
                                        "ClickhouseEngine": true
                                },
                                "UserENIStatus": false,
                                "VPCId": "vpc-bp15lqdl91m0fdc****",
                                "VSwitchId": "vsw-bp1k9jdi0yznq****",
                                "ZoneId": "cn-hangzhou-k"
                        }
                ]
        },
        "RequestId": "C42A167C-620C-5CF4-B016-663E3****"
}