Domain name for API request: tke.intl.tencentcloudapi.com.
This API can be called to acquire the ClusterRole tke:admin. By setting a CAM policy, you can grant permission of this API to a sub-account that has higher permission in CAM. In this way, this sub-account can call this API directly to acquire the admin role of a Kubernetes cluster.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: AcquireClusterAdminRole. |
Version | Yes | String | Common Params. The value used for this API: 2018-05-25. |
Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
ClusterId | Yes | String | Cluster ID |
Parameter Name | Type | Description |
---|---|---|
RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
This example shows you how to assign the cluster admin role to a sub-account to access resources in the Kubernetes cluster.
https://tke.intl.tencentcloudapi.com/?Action=AcquireClusterAdminRole
&ClusterId=cls-7ph3twqe
&<Common request parameters>
{
"Response": {
"RequestId": "24564577-a642-4164-8752-4668d4ca8886"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
FailedOperation.ComponentClientHttp | Internal HTTP client error. |
FailedOperation.KubernetesCreateOperationError | An error occurs while creating the cluster client. |
FailedOperation.KubernetesGetOperationError | |
InternalError | Internal error. |
InternalError.CamNoAuth | You do not have permissions. |
InternalError.KubernetesClientBuildError | Failed to create the kubernetes client. |
InternalError.KubernetesCreateOperationError | Failed to create the kubernetes resource. |
InternalError.KubernetesGetOperationError | Failed to obtain the kubernetes resources |
InternalError.UnexpectedInternal | Unknown internal error. |
InternalError.WhitelistUnexpectedError | Unknown allowlist error |
InvalidParameter | Parameter error. |
InvalidParameter.Param | Parameter error. |
ResourceNotFound | The resource does not exist. |
ResourceNotFound.ClusterNotFound | The cluster does not exist. |
ResourceUnavailable.ClusterState | The cluster status does not support this operation. |
UnauthorizedOperation.CamNoAuth | The API has no CAM permissions. |
UnsupportedOperation.NotInWhitelist | The user is not in the allowlist. |
Was this page helpful?