# Alibaba Cloud C++ Software Development Kit
[中文文档](./README_zh.md)

[![Build Status](https://travis-ci.org/aliyun/aliyun-openapi-cpp-sdk.svg?branch=master)](https://travis-ci.org/aliyun/aliyun-openapi-cpp-sdk)
[![codecov](https://codecov.io/gh/aliyun/aliyun-openapi-cpp-sdk/branch/master/graph/badge.svg)](https://codecov.io/gh/aliyun/aliyun-openapi-cpp-sdk)

The Alibaba Cloud C++ Software Development Kit (SDK) allows you to access Alibaba Cloud services such as Elastic Compute Service (ECS), Server Load Balancer (SLB), and CloudMonitor. You can access Alibaba Cloud services without the need to handle API related tasks, such as signing and constructing your requests.

This document introduces how to obtain and call Alibaba Cloud C++ SDK.

If you have any problem while using C++ SDK, please submit an [issue](https://github.com/aliyun/aliyun-openapi-cpp-sdk/issues/new).

## Prerequisites

- To use Alibaba Cloud C++ SDK, you must have an Alibaba Cloud account and an AccessKey.

	The AccessKey is required when initializing the client. You can create an AccessKey in the Alibaba Cloud console. For more information, see [Create an AccessKey](https://usercenter.console.aliyun.com/?spm=5176.doc52740.2.3.QKZk8w#/manage/ak).

	>**Note:** To increase the security of your account, we recommend that you use the AccessKey of the RAM user to access Alibaba Cloud services.

- To use Alibaba Cloud C++ SDK to access the APIs of a product, you must first activate the product on the [Alibaba Cloud console](https://home.console.aliyun.com/?spm=5176.doc52740.2.4.QKZk8w) if required.

- C++11 supported compiler installed
  - Windows: Visual Studio 2015 or newer
  - Linux: GCC 4.9 or newer
- CMake 3.0 or newer
- 4G memory or more

## Install C++ SDK from source code


### Linux

1. Install third-party libraries on the Linux platform, including `libcurl`, `libopenssl`, `libuuid`, and `libjsoncpp`.

	- Run the following commands on the `Redhat/Fedora` system
	```
    sudo dnf install libcurl-devel openssl-devel libuuid-devel libjsoncpp-devel
    ```
	- Run the following commands on the `Debian/Ubuntu` system
    ```
    sudo apt-get install libcurl4-openssl-dev libssl-dev uuid-dev libjsoncpp-dev
    ```
2. Run the following commands to clone source codes from GitHub.

    ```bash
    git clone https://github.com/aliyun/aliyun-openapi-cpp-sdk.git
    ```

3. Build and install SDK

  - Manually build and install

  ```bash
    cd aliyun-openapi-cpp-sdk
    mkdir sdk_build
    cd sdk_build
    cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ..
    make
    sudo make install
  ```

  - Or you may do this with `easyinstall.sh` in the source directory

  ```shell
    cd aliyun-openapi-cpp-sdk
    sudo sh easyinstall.sh
   ```

**The C++ SDK will be installed to `/usr`.**

### windows

1. Install [perl](https://www.perl.org/get.html#win32).

2. Run the following command to clone code from Github via git-bash:

  ```bash
  git clone https://github.com/aliyun/aliyun-openapi-cpp-sdk.git
  ```

2. Build Visual Studio solution

- Change directory to source code and make directory sdk_build

- Open CMake UI and

  - `Browse Source` to open source code directory.

  - `Browse build`  to open the created sdk_build directory

  - `Configure`

  - `Generate`

3. Build and Install C++ SDK

- Open `aliyun-openapi-cpp-sdk\\sdk_build\\alibabacloud-sdk.sln` with Visual Studio

- Select  `Release`

- Check INSTALL option from Build -> Configuration Manager

- Build->Build Solutions to build.

**SDK will be installed to `C:\Program File (x86)\alibabacloud-sdk`**


## Use the C++ SDK

Before using C++ SDK, you must first configure the preprocessor to define `ALIBABACLOUD_SHARED` to achieve dynamic linking with Alibaba Cloud C++ SDK shared libraries. Then you must create a client instance, specify the region of cloud services and provide authentication parameters before sending API requests.

The following code shows how to call the [DescribeInstances](~~25506~~) API of ECS to query detailed information of all ECS instances in a specific region.

```cpp
#include <iostream>
#include <alibabacloud/core/AlibabaCloud.h>
#include <alibabacloud/ecs/EcsClient.h>

using namespace AlibabaCloud;
using namespace AlibabaCloud::Ecs;

int main(int argc, char** argv) {
  // Initialize the SDK
  AlibabaCloud::InitializeSdk();

  // Configure the ECS instance
  ClientConfiguration configuration("<your-region-id>");
  EcsClient client("<your-access-key-id>", "<your-access-key-secret>", configuration);

  // Create an API request and set parameters
  Model::DescribeInstancesRequest request;
  request.setPageSize(10);

  auto outcome = client.describeInstances(request);
  if (!outcome.isSuccess()) {
    // Handle exceptions
    std::cout << outcome.error().errorCode() << std::endl;
    AlibabaCloud::ShutdownSdk();
    return -1;
  }

  std::cout << "totalCount: " << outcome.result().getTotalCount() << std::endl;

  // Close the SDK
  AlibabaCloud::ShutdownSdk();
  return 0;
}
```

Copy the above to ecs_test.cc, then build with the following command.

```bash
~$ g++ -o ecstest ecs_test.cc --std=c++11 -lalibabacloud-sdk-core -l alibabacloud-sdk-ecs
~$ ./ecstest
# Result or error message will be shown here.
~$
```

**More [examples](https://github.com/aliyun/aliyun-openapi-cpp-sdk/tree/master/examples)**

## LICENSE
Please refer to [LICENSE](https://github.com/aliyun/aliyun-openapi-cpp-sdk/blob/master/LICENSE) (Apache 2.0 LICENSE).