环境准备
环境要求
已下载并安装Go 1.10.x或以上版本。Go下载地址
安装 SDK 核心库 OpenAPI 。
go get github.com/alibabacloud-go/darabonba-openapi/v2/client
已下载并安装开发者工具,本文以GoLand为例。GoLand下载地址
已创建AccessKey。在调用阿里云API时您需要使用AccessKey完成身份验证。AccessKey包括AccessKey ID和AccessKey Secret。关于如何创建和获取AccessKey,请参见创建AccessKey。
验证版本
打开终端,输入go version
,查看Go 版本。
运行示例代码
步骤一:下载SDK完整工程
登录OpenAPI 门户。
在顶部导航栏,单击选择云产品,在弹出面板中根据需要选择云产品。
在云产品OpenAPI 主页,点击右上角去调试(图1),会弹出OpenAPI 调试页面(图2)。
图1
图2
左侧分栏选择您需要使用的接口,中间分栏填入接口需要的参数,右侧分栏选择SDK示例页签。
选择SDK版本为V2.0,选择所使用的语言。
说明 部分产品可能不支持选择SDK版本。请在步骤3的图1中查看云产品支持的SDK版本。
单击下载完整工程按钮,下载示例代码。
如果想要生成泛化调用代码,请勾选Common模式生成示例。更多信息请参见泛化调用与特化调用。
步骤二:配置环境变量
配置环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
重要 环境变量配置完成之后,需要重启您的所使用的开发工具(若不重启可能会无法正常读取环境变量)。
Linux和macOS系统配置方法
创建.bash_profile
文件
说明 如果是第一次设置环境变量,可以使用touch ~/.bash_profile
创建一个配置文件,如果已经存在配置文件,则使用vim ~/.bash_profile
命令直接编辑文件。
touch ~/.bash_profile
vim ~/.bash_profile
配置.bash_profile
文件
# 将以下命令中的<ACCESS_KEY_ID>和<ACCESS_KEY_SECRET>替换为您自己的AccessKey ID和AccessKey Secret。
# 变量名称可以根据实际情况进行替换,例如OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET。
export ALIBABA_CLOUD_ACCESS_KEY_ID=<ACCESS_KEY_ID>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<ACCESS_KEY_SECRET>
编辑完成后保存退出。
使用.bash_profile
文件
# 使配置文件生效
source ~/.bash_profile
# 显示配置是否生效
echo $ALIBABA_CLOUD_ACCESS_KEY_ID
若返回正确的AccessKey,则说明配置成功。
Windows系统配置方法
通过图形用户界面GUI
操作步骤
以下为Windows 10中通过图形用户界面设置环境变量的步骤。
在桌面右键单击此电脑,选择属性>高级系统设置>环境变量>系统变量/用户变量>新建,完成以下配置:
变量 | 示例值 |
AccessKey ID | |
AccessKey Secret | |
测试设置是否成功
单击开始(或快捷键:Win+R)> 运行(输入 cmd)> 确定(或按 Enter 键),打开命令提示符,执行echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
、echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%
命令。若返回正确的AccessKey,则说明配置成功。
通过命令行提示符CMD
操作步骤
以管理员身份打开命令提示符,并使用以下命令在系统中新增环境变量。
setx ALIBABA_CLOUD_ACCESS_KEY_ID3 LTAI4GDty8ab9W4Y1D**** /M
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET IrVTNZNy5yQelTETg0cZML3TQn**** /M
其中/M
表示系统级环境变量,设置用户级环境变量时可以不携带该参数。
测试设置是否成功
单击开始(或快捷键:Win+R)> 运行(输入 cmd)> 确定(或按 Enter 键),打开命令提示符,执行echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
、echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%
命令。若返回正确的AccessKey,则说明配置成功。
通过Windows PowerShell
在PowerShell中,设置新的环境变量(对所有新会话都有效):
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::User)
为所有用户设置环境变量(需要管理员权限):
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::Machine)
设置临时的环境变量(仅当前会话有效):
$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "LTAI4GDty8ab9W4Y1D****"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "IrVTNZNy5yQelTETg0cZML3TQn****"
在PowerShell中,执行Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID
、Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET
命令。若返回正确的AccessKey,则说明配置成功。
步骤三:运行代码
在GoLand中运行代码。查看控制台日志body中返回的相关信息和requestId
。
如果调用的是创建实例的接口,还会返回实例ID,您可以根据返回的实例ID去该产品的控制台验证。