CLI集成示例
阿里云命令行工具(Alibaba Cloud Command Line Interface)是基于OpenAPI建立的通用命令行工具,您可以借助阿里云CLI实现与文件存储CPFS服务进行交互,在Shell工具中管理您的CPFS资源。本文将为您介绍使用阿里云CLI调用文件存储CPFS的操作步骤和示例。
背景信息
阅读本文前,若您还不了解阿里云CLI,请参见什么是阿里云CLI。
安装阿里云CLI
使用阿里云CLI前,您需要先安装阿里云CLI。阿里云CLI为用户提供了Windows、Linux和macOS三种操作系统下的安装服务,请根据您使用设备的操作系统选择对应的安装服务。
您也可使用阿里云提供的云命令行Cloud Shell调试阿里云CLI命令。关于云命令行的更多信息,请参见什么是云命令行。
配置阿里云CLI
阿里云主账号拥有所有产品API的管理和访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。RAM用户需授予管理文件存储CPFS的权限AliyunNASFullAccess
。
使用阿里云CLI之前,您需要在阿里云CLI中配置身份凭证、地域ID等信息。阿里云CLI支持多种身份凭证,详情请参见身份凭证类型。本文操作以AK类型凭证为例,具体操作步骤如下:
创建RAM用户并授权后,您需要创建RAM用户对应的AccessKey,并记录
AccessKey ID
和AccessKey Secret
,以便后续配置身份凭证使用。具体操作,请参见创建AccessKey。配置凭证需要设置地域ID,阿里云CLI将使用您指定的地域发起API调用。可用地域请参见服务接入点。
说明使用阿里云CLI过程中您可使用
--region
选项指定地域发起命令调用,该选项在使用时将忽略默认身份凭证配置及环境变量设置中的地域信息。详情请参见API命令可用选项。使用RAM用户的AccessKey配置AK类型凭证,配置文件命名为
AkProfile
。具体操作,请参见配置示例。
生成CLI命令示例
在API调试界面左侧搜索框中可搜索您需要使用的API。在参数配置中根据API文档信息填写参数,单击参数配置右侧的CLI示例页签即可生成携带参数的命令示例。
使用CLI调用CPFS API
命令结构
阿里云CLI的通用命令行结构如下。更多详情,请参见命令结构。
aliyun <command> <subcommand> [options and parameters]
常用命令选项
在阿里云CLI中,您可根据需要使用命令行选项,用来修改命令的默认行为或为命令提供额外功能。常用命令行选项如下:
--profile<profileName>
:使用--profile
选项并指定有效配置名称profileName
后,阿里云CLI将忽略默认身份凭证配置及环境变量设置,优先使用指定的配置进行命令调用。--help
:在需要获取帮助的命令层级处键入--help
选项,即可获取该命令的帮助信息。更多详情,请参见获取帮助信息。
更多详细信息,请参见API命令可用选项。
调用示例
该示例以在Windows的命令提示符中调用为例,在其他操作系统中,运行命令的参数格式会有所不同,请注意参数格式。关于阿里云CLI命令参数使用格式的详细信息,请参见参数格式说明。
示例一:以下示例将为您展示如何使用阿里云CLI调用
CreateFileSystem
命令,在张家口可用区C创建一个100 MB/s/TiB基线的CPFS文件系统。执行命令。
aliyun nas CreateFileSystem --FileSystemType cpfs --ChargeType PayAsYouGo --StorageType advance_100 --ProtocolType cpfs --VpcId 'vpc-8vbqmlw7s97hu0q1d****' --VSwitchId 'vsw-8vbmuylc3di7980tj****' --ZoneId 'cn-zhangjiakou-c' --Capacity 3600
输出结果。
{ "FileSystemId": "cpfs-09b7d2b3149c****", "RequestId": "AEEABA87-2F97-5CB9-AA06-D438A78C6BBD" }
示例二:以下代码示例将为您展示如何使用
--help
选项获取文件存储CPFS支持阿里云CLI调用API列表。您也可以在API概览中查看支持调用的API。执行命令。
aliyun nas --help
输出结果。
如果调用API后返回错误,您需要根据返回的错误码提示检查传入的请求参数及其取值是否正确。
您也可以记录下调用返回的RequestID或SDK报错信息,通过阿里云OpenAPI诊断平台进行自助诊断。