Cloud Governance Center provides a visualized management console and allows you to call API operations in OpenAPI Explorer or by using SDKs. To improve the efficiency of your development by using Cloud Governance Center, we recommend that you select appropriate operations and integration methods based on your business requirements.
API overview
Alibaba Cloud provides OpenAPI Explorer for developers to understand and use the API operations of various Alibaba Cloud services in a quick and efficient manner. OpenAPI Explorer provides multiple features related to API operations, including intelligent search, documentation, online debugging, SDK download, sample code, error diagnosis, and call statistics. In OpenAPI Explorer, you can call the API operations of Alibaba Cloud services and view API requests and responses. In addition, OpenAPI Explorer automatically generates the corresponding SDK sample code to facilitate the use of Alibaba Cloud services. For more information, see What is an API?
API version
Alibaba CloudOpenAPI Explorer uses version numbers to manage the versions of cloud service APIs. For example, Cloud Governance Center currently supports API operations of version 2021-01-20. 2021-01-20 is an API version number rather than a date. Users are presented with the latest public information about the API. 2021-01-20 is not the last update date of the API.
API version | Description |
Recommended |
Online debugging
OpenAPI Explorer provides multiple features such as online debugging for the Cloud Governance Center API. Before you initiate a request, you must view related information including the supported API version, endpoints, and integration methods of the Cloud Governance Center API.
Debugging page
Endpoints
You can select an endpoint based on the region in which your resource resides to reduce latency. For example, the public endpoint of the Cloud Governance Center API of version 2021-01-20 in the China (Hangzhou) region is governance.cn-hangzhou.aliyuncs.com and the Virtual Private Cloud (VPC) endpoint is governance-vpc.cn-hangzhou.aliyuncs.com.
Public endpoints can be globally accessed.
VPC endpoints are accessible only within a VPC in a specific Alibaba Cloud region. VPC endpoints provide the following benefits:
Higher security: VPC endpoints can be accessed only within a VPC. This provides higher security and privacy.
Faster response: VPC endpoints use the internal network environment to deliver faster responses than those of public endpoints. In addition, by using VPC endpoints, you are free from issues such as network latency and bandwidth limits.
Lower cost: VPC endpoints are accessed over an internal network.
For more information, see Endpoints.
User identities
After you log on to OpenAPI Explorer by using your Alibaba Cloud account, OpenAPI Explorer uses your Alibaba Cloud account to perform online debugging by default. An Alibaba Cloud account has permissions on all API operations. Security risks may arise if you use an Alibaba Cloud account to debug API operations online. We recommend that you call API operations or perform routine O&M as a Resource Access Management (RAM) user. Before you call API operations as a RAM user, grant the required permissions to the RAM user based on your business requirements. To call the API operations of Cloud Governance Center as a RAM user, the RAM user must be authorized to manage Cloud Governance Center resources. For more information, see Use RAM for access control.
Identity | Supported |
Yes | |
RAM user (recommended) | Yes |
RAM role (recommended) | Yes |
References
Integration methods
SDKs can be easily integrated into your application and cover the widest range of operations. We recommend that you use SDKs to call API operations.
Overview of integration methods
Method | Supported |
Alibaba Cloud SDKs (recommended) | Yes |
No | |
No | |
Yes |
Alibaba Cloud SDKs
Alibaba Cloud provides SDKs in multiple programming languages, including Java, C#, Go, Python, Node.js, TypeScript, PHP, and C++. You can integrate SDKs into your applications to directly call API operations. SDKs encapsulate information such as the signature logic, timeout mechanism, and retry mechanism and return structured response objects based on specifications. This facilitates development. For more information, see Alibaba Cloud SDKs.
You can call the Cloud Governance Center API by using Alibaba Cloud SDKs. For more information about the supported languages and dependency installation methods, visit the page of Cloud Governance Center in OpenAPI Explorer.
Alibaba Cloud CLI
Alibaba Cloud CLI allows you to run
aliyuncommands to interact with Alibaba Cloud services and manage cloud service resources. For more information, see What is Alibaba Cloud CLI?You cannot call the Cloud Governance Center API by using Alibaba Cloud CLI.
ROS
ROS is an Alibaba Cloud service that allows you to manage cloud computing resources in a simplified manner. You can create templates to define the required Alibaba Cloud resources such as Elastic Compute Service (ECS) and ApsaraDB RDS instances, and dependency relationships between the resources. The ROS engine automatically creates and configures all resources in a stack based on a template to implement automated deployment and O&M. For more information, see What is ROS?
You cannot call the Cloud Governance Center API by using ROS.
Custom encapsulation
To make native HTTP calls, you must construct custom requests and sign the requests. For more information about the signature method, see List of operations by function and Request syntax and signature method V3.
Usage notes
If an error is returned after you call an API operation of Cloud Governance Center, you must check whether the related request parameters and values are valid based on the error code.
You can also perform self-service diagnostics based on the returned request ID or SDK error information on the OpenAPI problem diagnosis page.
References
Cloud Governance Center provides multiple features for enterprises that are using or have used cloud technologies to build services, including resource structure planning and building, identity and permission management, and compliance audit configuration. This helps enterprises build a secure, efficient, and manageable cloud environment. For more information, see What is Cloud Governance Center?
For more information about the languages supported by Cloud Governance Center SDKs, see SDK overview.