All Products
Search
Document Center

DataWorks:Usage notes of DataWorks API operations

Last Updated:Sep 20, 2024

This topic describes the usage notes of DataWorks API operations.

For information about Alibaba Cloud APIs, see Overview.

Basic information

Version

Version

Description

2020-05-18

Recommended

Endpoint

You must select an endpoint based on the region in which your DataWorks workspace resides to reduce the latency. For example, if your workspace is deployed in a virtual private cloud (VPC) in the China (Zhangjiakou) region, specify dataworks-vpc.cn-zhangjiakou.aliyuncs.com as the endpoint. For more information, see Endpoints.

API style

The API operations of DataWorks are called in the remote procedure call (RPC) style.

Call method

Call method

Supported

Description

Alibaba Cloud SDK (recommended)

Yes

For information about the programming languages supported by DataWorks SDKs and the methods to install dependencies, see DataWorks SDK.

Supported API operations

For more information, see List of operations by function.

Applicable scopes

  • Applicable editions:

    DataWorks provides various API operations, such as API operations related to tenants, metadata, DataStudio, and Operation Center. The API operations related to a DataWorks module have the same edition requirements as the DataWorks module.

    • For information about the limits on API operations that you can call in different DataWorks editions, see Call limits.

    • Each DataWorks edition provides a free quota for you to call API operations in each calendar month. After the free quota is used up, you are charged based on the pay-as-you-go billing method. For more information about the free quota and billing rules, see Free quota and billing rules.

  • Applicable regions:

    China (Hangzhou), China (Shanghai), China (Shenzhen), China (Beijing), China (Zhangjiakou), China North 2 Ali Gov, China East 2 Finance, China (Chengdu), China (Hong Kong), Singapore, Indonesia (Jakarta), US (Silicon Valley), US (Virginia), Germany (Frankfurt), UK (London), Japan (Tokyo), Australia (Sydney), and Malaysia (Kuala Lumpur)

Call limits

DataWorks API operations are classified into three levels to standardize API operation calls and ensure system stability. The following table describes the QPS limits and the maximum number of daily calls of API operations at different levels in different DataWorks editions.

Note

For information about how to view the free quota that DataWorks provides for API operation calls, the number of API operation calls that you have made, and API operation call details, see the View information about API calls section of the OpenAPI topic.

Edition

QPS limit

Maximum number of daily calls

Basic Edition

≤ 5 for API operations at level 1, level 2, or level 3

≤ 100

Standard Edition

≤ 1,000

Professional Edition

≤ 10,000

Enterprise Edition

  • ≤ 50 for API operations at level 1

  • ≤ 20 for API operations at level 2

  • ≤ 5 for API operations at level 3

  • Unlimited for API operations at level 1 or level 2

  • ≤ 10,000 for API operations at level 3

Important
  • The QPS and the number of API calls are calculated by accumulating the total QPS and the total number of calls in each region for an Alibaba Cloud account and RAM users within the Alibaba Cloud account.

  • If the QPS or the number of daily calls exceeds the upper limit, an API call will fail. We recommend you control the call concurrency and the number of initiated API calls.

  • The maximum number of daily calls includes the number of successful API calls and the number of failed API calls.

Free quota and billing rules

Each DataWorks edition provides a free quota for you to call API operations. After you use up the free quota, you are charged based on the pay-as-you-go billing method. The following table describes the billing rules for different editions of DataWorks.

Edition

Free quota

Pricing based on the pay-as-you-go billing method

Basic Edition

3,100 calls per month

Calls to the API operations are limited. The pay-as-you-go billing method is not supported.

Standard Edition

31,000 calls per month

Professional Edition

310,000 calls per month

Enterprise Edition

1,000,000 calls per month

USD 0.05 per 10,000 calls

Important
  • DataWorks provides a free quota for you to call API operations in each calendar month in each region. This free quota is shared by your Alibaba Cloud account and RAM users within your Alibaba Cloud account. The free quota varies based on the DataWorks edition.

  • Due to the limits on the maximum number of daily calls of API operations in different DataWorks editions, the actual monthly quota for you to call API operations in DataWorks Basic Edition, DataWorks Standard Edition, and DataWorks Professional Edition may be less than the free quota provided by DataWorks. For more information, see Call limits.

  • After the free quota provided by DataWorks Enterprise Edition is used up, you are charged based on the pay-as-you-go billing method. The actual price in your bills prevails.

  • The free quota is used only after API operations are successfully called. After the free quota is used up, you are charged based on the pay-as-you-go billing method. If API operations fail to be called, the free quota is not used, and you are not charged.