All Products
Search
Document Center

Container Compute Service:Customize the SANs of a cluster's API server certificate

Last Updated:Sep 16, 2025

The API server certificate of an Alibaba Cloud Container Compute Service (ACS) cluster contains the Subject Alternative Name (SAN) field. By default, this field includes the cluster's domain name, the private IP address of the API server's Server Load Balancer (SLB) instance, the local IP address of the API server service, and the public Elastic IP Address (EIP). If you have special requirements for proxy or cross-domain access, you can customize the SAN field for an existing cluster in the console.

Prerequisites

An ACS cluster is created. For more information, see Create an ACS cluster.

Important

You cannot customize the SANs for an ACS cluster when you create the cluster. You can only update the SANs for an existing ACS cluster.

SAN overview

SAN is an extension to the X.509 standard. It lets you associate multiple values with an SSL certificate using the subjectAltName field. These values can include IP addresses, domain names, URIs, and email addresses.

Customize the SANs of the API server certificate

Important

Updating or modifying the custom SANs triggers a brief restart of the cluster's API server. Perform this operation during off-peak hours.

  1. Log on to the ACS console. In the left-side navigation pane, click Clusters.

  2. On the Clusters page, find the cluster that you want to manage and click its ID or click Details in the Actions column of the cluster.

  3. On the cluster details page, click the Basic Information tab, and then click Edit to the right of Custom Certificate SANs.

  4. In the Update Custom Certificate SAN dialog box, configure the Custom Certificate SANs field and click OK.