全部产品
Search
文档中心

阿里云SDK:快速开始

更新时间:Dec 15, 2023

本文为您介绍如何安装Go环境并提供安装步骤、示例代码及API使用方法,帮助您快速上手构建云服务,实现API调用和服务集成。

环境准备

环境要求

  • 已下载并安装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完整工程

  1. 登录OpenAPI 门户

  2. 在顶部导航栏,单击选择云产品,在弹出面板中根据需要选择云产品。

  3. 进入云产品主页,在顶部导航栏单击API调试,会出现三栏的页面。

    image.png

  4. 左侧分栏选择您需要使用的接口,中间分栏填入接口需要的参数,右侧分栏选择SDK示例页签。

  5. 选择SDK版本V2.0,根据需要选择需要的语言。

  6. 单击下载完整工程按钮,下载示例代码。

  7. 如果想要生成泛化调用代码,请勾选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。
      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
  • Windows系统:新建环境变量文件,添加环境变量ALIBABA_CLOUD_ACCESS_KEY_IDALIBABA_CLOUD_ACCESS_KEY_SECRET,并写入已准备好的AccessKey ID和AccessKey Secret。

重启IDE(不重启可能会出现无法读取环境变量的情况)。

步骤三:运行代码

  1. 在GoLand中运行代码。查看控制台日志body中返回的相关信息和requestId

  2. 如果调用的是创建实例的接口,还会返回实例ID,您可以根据返回的实例ID去该产品的控制台验证。