Container Registry ACR integration methods - SDK, CLI, Terraform, ROS - Container Registry

Container Registry ACR supports multiple integration methods, including the console, OpenAPI Explorer, Alibaba Cloud SDK, and Resource Orchestration Service (ROS).

OpenAPI Explorer

OpenAPI Explorer lets you search, debug, and call API operations of Alibaba Cloud services. It also generates SDK sample code and provides error diagnosis and call statistics. What is an API?

Version description

API version	Description
2018-12-01	Recommended

Online debugging

Container Registry supports API debugging in OpenAPI Explorer. Before calling an API operation, familiarize yourself with the available versions, endpoints, and integration methods.

For example, to debug the ListInstance API operation, select it from the left pane. Select an endpoint such as China (Qingdao), configure parameters such as InstanceName, InstanceStatus, ResourceGroupId, PageNo, and PageSize, then click Send Request. The right panel displays documentation, responses, and SDK/CLI sample code.

Debugging page

The URL for API debugging is https://next.api.aliyun.com/api/cr/2018-12-01/GetInstance.

Endpoint description

Container Registry is available in multiple regions. Public endpoint format: cr.{regionId}.aliyuncs.com. VPC endpoint format: cr-vpc.{regionId}.aliyuncs.com. Endpoints.

Identities

By default, OpenAPI Explorer uses your Alibaba Cloud account to debug API operations. Because an Alibaba Cloud account has full permissions, we recommend that you use a RAM user or RAM role for routine operations. Grant the RAM identity permissions to operate Container Registry resources before calling API operations. Attach system policies to the RAM user.

Identity	Supported
Alibaba Cloud account	Yes
RAM user (recommended)	Yes
RAM role (recommended)	Yes

Integration methods

Note

We recommend SDKs for most use cases. SDKs integrate easily with your applications and cover the widest range of operations.

Supported methods

Method	Supported
(Recommended) Alibaba Cloud SDKs	Yes
Alibaba Cloud CLI	Yes
Resource Orchestration Service (ROS)	Yes
Terraform	Yes
Custom HTTP encapsulation	Yes

Alibaba Cloud SDKs

Alibaba Cloud SDKs are available in Java, C#, Go, Python, TypeScript, Node.js, PHP, and C++. SDKs handle signature logic, timeouts, and retries, and return structured response objects. Alibaba Cloud SDKs.
For supported languages and installation instructions, see Container Registry SDK.

Alibaba Cloud CLI

Run aliyun commands to manage cloud resources from the terminal. What is Alibaba Cloud CLI?

Terraform

Terraform is an open source infrastructure-as-code tool that manages cloud resources through declarative templates, similar to ROS. What is Terraform?
To orchestrate Container Registry with Terraform, see Terraform usage examples.

The following table lists the Terraform resources available for Container Registry.

Resource	Description
alicloud_cr_ee_sync_rule	Synchronization rules for Enterprise Edition.
alicloud_cr_ee_instance	Enterprise Edition instances.
alicloud_cr_ee_namespace	Namespaces for Enterprise Edition instances.
alicloud_cr_ee_repo	Image repositories for Enterprise Edition instances.
alicloud_cr_chain	Image pipelines.
alicloud_cr_chart_namespace	Chart namespaces.
alicloud_cr_chart_repository	Chart repositories.
alicloud_cr_endpoint_acl_policy	Network access control.
alicloud_cr_vpc_endpoint_linked_vpc	VPC endpoint connections.

Custom API encapsulation

For native HTTP calls, you must construct and sign requests manually. Custom encapsulation.