All Products
Search
Document Center

Container Service for Kubernetes:CreateHubCluster

Last Updated:May 22, 2024

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

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

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:CreateHubClusterWrite
  • All Resources
    *
    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 changedsee changesets
Change itemChange content
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: Tag
2024-04-16The request parameters of the API has changedsee changesets
Change itemChange content
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: ResourceGroupID
2024-03-27The internal configuration of the API is changed, but the call is not affectedsee changesets
Change itemChange content
The internal configuration of the API is changed, but the call is not affected.
2023-10-18API Description Updatesee changesets
Change itemChange content
API DescriptionAPI Description Update.
2021-12-31Add Operationsee changesets