All Products
Search
Document Center

Container Service for Kubernetes:CreateHubCluster

Last Updated:Dec 25, 2024

Creates a master instance in Alibaba Cloud Distributed Cloud Container Platform (ACK One).

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
adcp:CreateHubClustercreate
*Cluster
acs:adcp:{#regionId}:{#accountId}:cluster/*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The ID of the region. You can call the DescribeRegions operation to query available regions.

cn-beijing
VpcIdstringYes

The ID of the virtual private cloud (VPC) to which the master instance belongs. You can call the DescribeVpcs operation to query available VPCs.

vpc-f8zin0jscsr84s96tg***
ApiServerPublicEipbooleanNo

Specifies whether to expose the API server to the Internet. Valid values:

  • true: exposes the API server to the Internet.
  • false: exposes the API server to the internal network.
true
NamestringNo

The name of the master instance.

ack-demo
VSwitchesstringYes

The ID of the vSwitch.

["vsw-2zeaijsas4zkzz81xm***"]
AuditLogEnabledbooleanNo

Specifies whether to enable the audit log feature. Valid values:

  • true: enables the audit log feature.
  • false: disables the audit log feature.
false
IsEnterpriseSecurityGroupbooleanNo

Specifies whether to use an advanced security group.

false
ProfilestringNo

The type of scenario for which the master instance is suitable. Valid values:

  • Default: The master instance is suitable for standard scenarios.
  • XFlow: The master instance is suitable for workflow scenarios.

Default value: Default.

Default
ArgoServerEnabledbooleanNo

Specifies whether to enable the workflow instance UI. This parameter takes effect only if Profile is set to XFlow. Valid values:

  • true
  • false
true
WorkflowScheduleModestringNo

The scheduling mode of the workflow. This parameter takes effect only if Profile is set to XFlow. Valid values:

  • cost-optimized: cost-prioritized scheduling mode.
  • stock-optimized: inventory-prioritized scheduling mode.
cost-optimized
PriceLimitstringNo

The limit on the prices of containers in the workflow. This parameter takes effect only if the WorkflowScheduleMode parameter is set to cost-optimized.

0.08
ResourceGroupIDstringNo

The Resource Group ID.

rg-1exm6tg2h48***
TagarrayNo

The tags.

You can specify at most 20 tags in each call.

TagNo

The list of tags.

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

62F5AA2B-A2C9-5135-BCE2-C2167099****
ClusterIdstring

The ID of the master instance.

c09946603cd764dac96135f51d1ba****
TaskIdstring

The ID of the task.

T-62523eda841eca071400****

Examples

Sample success responses

JSONformat

{
  "RequestId": "62F5AA2B-A2C9-5135-BCE2-C2167099****",
  "ClusterId": "c09946603cd764dac96135f51d1ba****",
  "TaskId": "T-62523eda841eca071400****"
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-05-13The request parameters of the API has changedView Change Details
2024-04-16The request parameters of the API has changedView Change Details
2024-03-27The internal configuration of the API is changed, but the call is not affectedView Change Details
2023-10-18API Description UpdateView Change Details
2021-12-31Add OperationView Change Details