{"openapi":"3.1.0","info":{"title":"Converge Cloud — Kubernetes Engine (tke)","version":"2018-05-25","summary":"22 actions.","description":"Endpoint `https://tke.api3.convergecloud.com`, region `luzon`, `X-TC-Version: 2018-05-25`.\n\nA wrong `X-TC-Version` returns `InvalidAction`, which is indistinguishable from a missing action — this was the single largest source of false “absent” verdicts in our own measurements."},"servers":[{"url":"https://tke.api3.convergecloud.com","description":"Converge Cloud production (luzon — the only region)"}],"x-cc-wire-protocol":{"style":"RPC over HTTP POST","realPath":"/","actionHeader":"X-TC-Action","versionHeader":"X-TC-Version","version":"2018-05-25","note":"Every operation in this document is really `POST /` to the server above with `X-TC-Action: <Action>`. Paths of the form `/tke/<Action>` exist so the actions are individually addressable, linkable and renderable; they are not routes on the server.","signing":"TC3-HMAC-SHA256","region":"luzon","clockSkewSeconds":300},"security":[{"TC3":[]}],"tags":[{"name":"tke","description":"Kubernetes Engine"}],"paths":{"/tke/DescribeClusters":{"post":{"operationId":"tke_DescribeClusters","summary":"DescribeClusters","description":"Query clusters list.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusters' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"Offset\":0,\"Limit\":20}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusters","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":[],"x-cc-notable-params":["ClusterIds","Filters","Offset","Limit"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterIds":{"type":"array","items":{"type":"string"},"description":"Optional."},"Filters":{"type":"array","description":"Server-side filters. Unknown filter names are rejected rather than ignored. Optional.","items":{"type":"object","properties":{"Name":{"type":"string"},"Values":{"type":"array","items":{"type":"string"}}},"required":["Name","Values"]}},"Offset":{"type":"integer","minimum":0,"description":"Zero-based pagination offset. Optional."},"Limit":{"type":"integer","minimum":0,"description":"Page size. Optional."}},"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"Offset":0,"Limit":20}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"recorded1":{"summary":"Example response","value":{"Response":{"TotalCount":0,"Clusters":[],"RequestId":"44554842-0b6d-45f2-f291-f88f56c03d6c"}}},"recorded2":{"summary":"Example response 2","value":{"Response":{"TotalCount":0,"Clusters":[],"RequestId":"13dbd69a-f9cf-4d24-0dc5-b12de49916b4"}}},"recorded3":{"summary":"Example response 3","value":{"Response":{"TotalCount":0,"Clusters":[],"RequestId":"0c8a1c3b-f939-158f-670b-5b065be44020"}}}}}}}}}},"/tke/DescribeClusterStatus":{"post":{"operationId":"tke_DescribeClusterStatus","summary":"DescribeClusterStatus","description":"Query the information of clusters under the current account.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusterStatus' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusterStatus","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":[],"x-cc-notable-params":["ClusterIds"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterIds":{"type":"array","items":{"type":"string"},"description":"Optional."}},"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"recorded1":{"summary":"Example response","value":{"TotalCount":0,"ClusterStatusSet":[]}}}}}}}}},"/tke/DescribeVersions":{"post":{"operationId":"tke_DescribeVersions","summary":"DescribeVersions","description":"Query cluster version information.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeVersions' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeVersions","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":[],"x-cc-notable-params":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"recorded1":{"summary":"Example response","value":{"TotalCount":6,"VersionInstanceSet":[{"Name":"k8s","Remark":"SUITABLE_FOR_INDEPENDENT_CLUSTER","Version":"1.14.3"},{"Name":"k8s","Remark":"SUITABLE_FOR_INDEPENDENT_CLUSTER","Version":"1.16.3"},{"Name":"k8s","Remark":"SUITABLE_FOR_INDEPENDENT_CLUSTER","Version":"1.18.4"},{"Name":"k8s","Remark":"SUITABLE_FOR_INDEPENDENT_CLUSTER","Version":"1.20.6"},{"Name":"k8s","Remark":"SUITABLE_FOR_INDEPENDENT_CLUSTER","Version":"1.22.5"},{"Name":"k8s","Remark":"SUITABLE_FOR_INDEPENDENT_CLUSTER","Version":"1.30.0"}],"RequestId":"6bfbda18-a2d2-e9a0-f4e8-f3ce5ce3b11f"}}}}}}}}},"/tke/DescribeImages":{"post":{"operationId":"tke_DescribeImages","summary":"DescribeImages","description":"Get image information.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeImages' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeImages","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":[],"x-cc-notable-params":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"recorded1":{"summary":"Example response","value":{"TotalCount":4,"ImageInstanceSet":[{"Alias":"UOS 20.0 64bit","OsName":"uos20.0x86_64","ImageId":"img-974pvwjv","OsCustomizeType":"GENERAL","Arch":"x86","SportIpv6":"No"},{"Alias":"Kylin V10(ARM64)","OsName":"kylinv10arm_64","ImageId":"img-m0w653yh","OsCustomizeType":"GENERAL","Arch":"arm","SportIpv6":"No"},{"Alias":"UOS V20(ARM64)","OsName":"uosv20arm_64","ImageId":"img-qy9cmey3","OsCustomizeType":"GENERAL","Arch":"arm","SportIpv6":"No"},{"Alias":"Ubuntu 20.04 64bit","OsName":"ubuntu20.04x86_64","ImageId":"img-ay3ac80x","OsCustomizeType":"GENERAL","Arch":"x86","SportIpv6":"No"}],"RequestId":"10d92b77-2e52-e650-6a03-647aa2803d8f"}}}}}}}}},"/tke/DescribeRegions":{"post":{"operationId":"tke_DescribeRegions","summary":"DescribeRegions","description":"Obtain all regions supported by TKE.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeRegions' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeRegions","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":[],"x-cc-notable-params":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"recorded1":{"summary":"Example response","value":{"TotalCount":1,"RegionInstanceSet":[{"Alias":"luzon","FeatureGates":"","RegionId":50000001,"RegionName":"luzon","Remark":"","Status":"AVAILABLE"}],"RequestId":"25595226-2abe-8029-5ffd-f90ebc3f6483"}}}}}}}}},"/tke/DescribeClusterLevelAttribute":{"post":{"operationId":"tke_DescribeClusterLevelAttribute","summary":"DescribeClusterLevelAttribute","description":"Obtain the cluster model.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusterLevelAttribute' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusterLevelAttribute","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":[],"x-cc-notable-params":["ClusterId"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string","description":"Optional."}},"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/tke/DescribeClusterInstances":{"post":{"operationId":"tke_DescribeClusterInstances","summary":"DescribeClusterInstances","description":"Query information of node instances in a cluster.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusterInstances' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusterInstances","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":["ClusterId"],"x-cc-notable-params":["Offset","Limit","InstanceIds","InstanceRole"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"Offset":{"type":"integer","minimum":0,"description":"Zero-based pagination offset. Optional."},"Limit":{"type":"integer","minimum":0,"description":"Page size. Optional."},"InstanceIds":{"type":"array","items":{"type":"string"},"description":"Optional."},"InstanceRole":{"type":"string","description":"Optional."}},"required":["ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/tke/DescribeClusterSecurity":{"post":{"operationId":"tke_DescribeClusterSecurity","summary":"DescribeClusterSecurity","description":"Query the key information of a cluster.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusterSecurity' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusterSecurity","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":["ClusterId"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"}},"required":["ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/tke/DescribeClusterEndpointStatus":{"post":{"operationId":"tke_DescribeClusterEndpointStatus","summary":"DescribeClusterEndpointStatus","description":"Query cluster access port status (intranet / extranet access is enabled for independent clusters, and intranet access is supported for managed clusters).\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusterEndpointStatus' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusterEndpointStatus","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":["ClusterId"],"x-cc-notable-params":["IsExtranet"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"IsExtranet":{"type":"boolean","description":"Optional."}},"required":["ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/tke/DescribeClusterKubeconfig":{"post":{"operationId":"tke_DescribeClusterKubeconfig","summary":"DescribeClusterKubeconfig","description":"Obtain the cluster kubeconfig file. Different sub-accounts have their own kubeconfig files. The kubeconfig file contains the kube-apiserver client certificate of the corresponding sub-account. By default, the client certificate is created when this API is called for the first time, and the certificate is valid for 20 years with no permissions granted. For the cluster owner or primary account, the cluster-admin permission is granted by default.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusterKubeconfig' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusterKubeconfig","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":["ClusterId"],"x-cc-notable-params":["IsExtranet"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"IsExtranet":{"type":"boolean","description":"Optional."}},"required":["ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/tke/DescribeClusterAsGroups":{"post":{"operationId":"tke_DescribeClusterAsGroups","summary":"DescribeClusterAsGroups","description":"Cluster-associated scaling group list.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusterAsGroups' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusterAsGroups","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":["ClusterId"],"x-cc-notable-params":["AutoScalingGroupIds"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"AutoScalingGroupIds":{"type":"array","items":{"type":"string"},"description":"Optional."}},"required":["ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/tke/DescribeAvailableClusterVersion":{"post":{"operationId":"tke_DescribeAvailableClusterVersion","summary":"DescribeAvailableClusterVersion","description":"Obtain all versions that the cluster can upgrade to.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeAvailableClusterVersion' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeAvailableClusterVersion","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":["ClusterId"],"x-cc-notable-params":["ClusterIds"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"ClusterIds":{"type":"array","items":{"type":"string"},"description":"Optional."}},"required":["ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/tke/DescribeClusterCommonNames":{"post":{"operationId":"tke_DescribeClusterCommonNames","summary":"DescribeClusterCommonNames","description":"Obtain the CommonName from the kube-apiserver client certificate that corresponding to the sub-account in RBAC authorization mode.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeClusterCommonNames' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"SubaccountUins\":\"<SubaccountUins>\",\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeClusterCommonNames","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":["SubaccountUins","ClusterId"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"SubaccountUins":{"type":"string"},"ClusterId":{"type":"string"}},"required":["SubaccountUins","ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"SubaccountUins":"<SubaccountUins>","ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/tke/DescribeExistedInstances":{"post":{"operationId":"tke_DescribeExistedInstances","summary":"DescribeExistedInstances","description":"Query one or more existing node and determine whether they can be added to a cluster.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DescribeExistedInstances' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"Offset\":0,\"Limit\":20}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DescribeExistedInstances","x-cc-version":"2018-05-25","x-cc-mutating":false,"x-cc-required-params":[],"x-cc-notable-params":["ClusterId","InstanceIds","Filters","Offset","Limit"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string","description":"Optional."},"InstanceIds":{"type":"array","items":{"type":"string"},"description":"Optional."},"Filters":{"type":"array","description":"Server-side filters. Unknown filter names are rejected rather than ignored. Optional.","items":{"type":"object","properties":{"Name":{"type":"string"},"Values":{"type":"array","items":{"type":"string"}}},"required":["Name","Values"]}},"Offset":{"type":"integer","minimum":0,"description":"Zero-based pagination offset. Optional."},"Limit":{"type":"integer","minimum":0,"description":"Page size. Optional."}},"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"Offset":0,"Limit":20}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"recorded1":{"summary":"Example response","value":{"Response":{"RequestId":"3fcc2ee1-804e-a5d9-b81c-7926c0ab3808","Error":{"Code":"InternalError","Message":"[Type 9000] request to backend error, msg is Bad Gateway"}}}}}}}}}}},"/tke/CreateCluster":{"post":{"operationId":"tke_CreateCluster","summary":"CreateCluster","description":"Create a cluster.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: CreateCluster' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterType\":\"<ClusterType>\",\"ClusterCIDRSettings\":\"<ClusterCIDRSettings>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"CreateCluster","x-cc-version":"2018-05-25","x-cc-mutating":true,"x-cc-required-params":["ClusterType","ClusterCIDRSettings"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterType":{"type":"string"},"ClusterCIDRSettings":{"type":"string"}},"required":["ClusterType","ClusterCIDRSettings"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterType":"<ClusterType>","ClusterCIDRSettings":"<ClusterCIDRSettings>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"error1":{"summary":"Example error response 1","value":{"Response":{"RequestId":"146f6ef6-396d-a68b-5955-3e7c4bc1565f","Error":{"Code":"UnknownParameter","Message":"failed to get subnet"}}}}}}}}}}},"/tke/DeleteCluster":{"post":{"operationId":"tke_DeleteCluster","summary":"DeleteCluster","description":"Delete a cluster. (Cloud API v3).\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DeleteCluster' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\",\"InstanceDeleteMode\":\"<InstanceDeleteMode>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DeleteCluster","x-cc-version":"2018-05-25","x-cc-mutating":true,"x-cc-required-params":["ClusterId","InstanceDeleteMode"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"InstanceDeleteMode":{"type":"string"}},"required":["ClusterId","InstanceDeleteMode"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>","InstanceDeleteMode":"<InstanceDeleteMode>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"error1":{"summary":"Example error response 1","value":{"Response":{"RequestId":"3c296183-cba0-3b10-b6bc-b054c6192b31","Error":{"Code":"InternalError","Message":"get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}},"error2":{"summary":"Example error response 2","value":{"Response":{"RequestId":"b76cb8b0-70a3-95bc-838f-05bb7859a391","Error":{"Code":"InternalError","Message":"get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}}}}}}}}},"/tke/CreateClusterInstances":{"post":{"operationId":"tke_CreateClusterInstances","summary":"CreateClusterInstances","description":"Create one or more nodes in a cluster.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: CreateClusterInstances' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\",\"RunInstancePara\":\"<RunInstancePara>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"CreateClusterInstances","x-cc-version":"2018-05-25","x-cc-mutating":true,"x-cc-required-params":["ClusterId","RunInstancePara"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"RunInstancePara":{"type":"string"}},"required":["ClusterId","RunInstancePara"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>","RunInstancePara":"<RunInstancePara>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"error1":{"summary":"Example error response 1","value":{"Response":{"RequestId":"ab245760-5e6d-f067-ac7c-a6da773bcbb9","Error":{"Code":"InternalError","Message":"get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}},"error2":{"summary":"Example error response 2","value":{"Response":{"RequestId":"3cdae474-7151-83e6-34a8-8601694482c6","Error":{"Code":"InternalError","Message":"get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}}}}}}}}},"/tke/DeleteClusterInstances":{"post":{"operationId":"tke_DeleteClusterInstances","summary":"DeleteClusterInstances","description":"Delete one or more nodes from a cluster.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: DeleteClusterInstances' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\",\"InstanceIds\":[\"<InstanceId>\"],\"InstanceDeleteMode\":\"<InstanceDeleteMode>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"DeleteClusterInstances","x-cc-version":"2018-05-25","x-cc-mutating":true,"x-cc-required-params":["ClusterId","InstanceIds","InstanceDeleteMode"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"InstanceIds":{"type":"array","items":{"type":"string"}},"InstanceDeleteMode":{"type":"string"}},"required":["ClusterId","InstanceIds","InstanceDeleteMode"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>","InstanceIds":["<InstanceId>"],"InstanceDeleteMode":"<InstanceDeleteMode>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"error1":{"summary":"Example error response 1","value":{"Response":{"RequestId":"","Error":{"Code":"InternalError","Message":"get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}},"error2":{"summary":"Example error response 2","value":{"Response":{"RequestId":"","Error":{"Code":"InternalError","Message":"get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}}}}}}}}},"/tke/ModifyClusterAttribute":{"post":{"operationId":"tke_ModifyClusterAttribute","summary":"ModifyClusterAttribute","description":"Modify cluster attributes.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: ModifyClusterAttribute' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"ModifyClusterAttribute","x-cc-version":"2018-05-25","x-cc-mutating":true,"x-cc-required-params":["ClusterId"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"}},"required":["ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"error1":{"summary":"Example error response 1","value":{"Response":{"RequestId":"893dae6d-82ae-1d6d-9df1-f55c4938a8e4","Error":{"Code":"InvalidParameter","Message":"get cluster failed: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}}}}}}}}},"/tke/AddExistedInstances":{"post":{"operationId":"tke_AddExistedInstances","summary":"AddExistedInstances","description":"Add one or more existing instances to a cluster.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: AddExistedInstances' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\",\"InstanceIds\":[\"<InstanceId>\"]}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"AddExistedInstances","x-cc-version":"2018-05-25","x-cc-mutating":true,"x-cc-required-params":["ClusterId","InstanceIds"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"InstanceIds":{"type":"array","items":{"type":"string"}}},"required":["ClusterId","InstanceIds"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>","InstanceIds":["<InstanceId>"]}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"error1":{"summary":"Example error response 1","value":{"Response":{"RequestId":"c3ededfb-5522-2bd0-c14e-fc9dc3540a27","Error":{"Code":"InternalError","Message":"get cluster from platform-api failed, err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}},"error2":{"summary":"Example error response 2","value":{"Response":{"RequestId":"2a625c66-bd6e-2e8c-795a-2d91c3b85375","Error":{"Code":"InternalError","Message":"get cluster from platform-api failed, err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}}}}}}}}},"/tke/UpdateClusterVersion":{"post":{"operationId":"tke_UpdateClusterVersion","summary":"UpdateClusterVersion","description":"Upgrade the master component of the cluster to the specified version.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: UpdateClusterVersion' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\",\"DstVersion\":\"<DstVersion>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"UpdateClusterVersion","x-cc-version":"2018-05-25","x-cc-mutating":true,"x-cc-required-params":["ClusterId","DstVersion"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"},"DstVersion":{"type":"string"}},"required":["ClusterId","DstVersion"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>","DstVersion":"<DstVersion>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"error1":{"summary":"Example error response 1","value":{"Response":{"RequestId":"064519d9-f107-44bb-9bf5-a845e3805c9f","Error":{"Code":"FailedOperation","Message":"get cluster failed, err: clusters.platform.tkestack.io \"cls-00000000\" not found."}}}}}}}}}}},"/tke/CreateClusterEndpoint":{"post":{"operationId":"tke_CreateClusterEndpoint","summary":"CreateClusterEndpoint","description":"Create a cluster access endpoint.\n**Wire call.** This path is a documentation convenience. Converge Cloud is RPC-over-HTTP: every action is a single `POST /` to `tke.api3.convergecloud.com` with the action name in the `X-TC-Action` header. The real request is:\n```bash\ncurl -sS https://tke.api3.convergecloud.com/ \\\n  -H 'Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<YYYY-MM-DD>/tke/tc3_request, SignedHeaders=content-type;host;x-tc-action, Signature=<sig>' \\\n  -H 'Content-Type: application/json; charset=utf-8' \\\n  -H 'Host: tke.api3.convergecloud.com' \\\n  -H 'X-TC-Action: CreateClusterEndpoint' \\\n  -H 'X-TC-Version: 2018-05-25' \\\n  -H 'X-TC-Timestamp: <unix-seconds>' \\\n  -H 'X-TC-Region: luzon' \\\n  -d '{\"ClusterId\":\"<ClusterId>\"}'\n```","tags":["tke"],"deprecated":false,"x-cc-service":"tke","x-cc-action":"CreateClusterEndpoint","x-cc-version":"2018-05-25","x-cc-mutating":true,"x-cc-required-params":["ClusterId"],"x-cc-notable-params":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ClusterId":{"type":"string"}},"required":["ClusterId"],"additionalProperties":true,"description":"The fields listed here are the ones in common use. Additional parameters are also accepted."},"example":{"ClusterId":"<ClusterId>"}}}},"responses":{"200":{"description":"Converge Cloud answers 200 for both success and error. Read `Response.Error` to tell them apart — never the HTTP status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"examples":{"error1":{"summary":"Example error response 1","value":{"Response":{"RequestId":"cc43b62b-c4f5-7acd-e408-0e2c7fe08327","Error":{"Code":"InternalError","Message":"Phase 2 [getClusterInformation]: get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}},"error2":{"summary":"Example error response 2","value":{"Response":{"RequestId":"8cb5bb80-c7ca-ed61-d133-b2fda6b632f8","Error":{"Code":"InternalError","Message":"Phase 2 [getClusterInformation]: get cluster cls-00000000 failed ,err: clusters.platform.tkestack.io \"cls-00000000\" not found"}}}}}}}}}}}},"components":{"securitySchemes":{"TC3":{"type":"apiKey","in":"header","name":"Authorization","description":"TC3-HMAC-SHA256. Credential scope is `<YYYY-MM-DD>/tke/tc3_request`. The signing service name is a separate input from the hostname — deriving it from the host works until it does not, and the failure looks like an auth bug. Timestamps outside a 300-second window are rejected."}},"schemas":{"Envelope":{"type":"object","description":"Every Converge Cloud response is wrapped in `Response`, success or failure.","properties":{"Response":{"type":"object","properties":{"RequestId":{"type":"string","description":"Always present, including on errors. Quote it to Converge support."},"Error":{"$ref":"#/components/schemas/Error"}},"required":["RequestId"],"additionalProperties":true}},"required":["Response"]},"Error":{"type":"object","description":"Present only on failure. Error messages are Chinese on vpc and dc and English elsewhere — parse `Code`, never `Message`.","properties":{"Code":{"type":"string","examples":["InvalidAction","UnauthorizedOperation","AuthFailure.SignatureFailure","ResourceNotFound","InvalidParameterValue.LimitExceeded"]},"Message":{"type":"string"}},"required":["Code","Message"]}}}}