Skip to content

TKE-30: 修正删除节点 API 参数与响应语义#63

Open
wenjiehs wants to merge 1 commit into
tke-workshop:mainfrom
wenjiehs:agent/tke-workshop-doc-change-agent/31209073
Open

TKE-30: 修正删除节点 API 参数与响应语义#63
wenjiehs wants to merge 1 commit into
tke-workshop:mainfrom
wenjiehs:agent/tke-workshop-doc-change-agent/31209073

Conversation

@wenjiehs

@wenjiehs wenjiehs commented Jul 1, 2026

Copy link
Copy Markdown
Collaborator

Closes TKE-30

Doc Change Report

Source Issue

  • TKE-30: Doc Change: 修正删除 TKE 节点 API 文档链接与响应语义

Document Identity

  • canonical_doc_path: src/content/docs/basics/node/02-delete-node.md
  • operation_id: tke.node.delete
  • Duplicate operation check: only the node delete canonical page was changed; related node maintenance and node query pages link to this page rather than duplicating the delete operation.

Scope

  • Updated DeleteClusterInstances parameter guidance so InstanceDeleteMode is explicit and required for the China-site API contract.
  • Updated tccli, Python SDK, Go SDK, and advanced examples to pass InstanceDeleteMode.
  • Replaced the incorrect DeleteCluster API documentation link with the DeleteClusterInstances page.
  • Expanded the response example and explanation to include SuccInstanceIds, FailedInstanceIds, and NotFoundInstanceIds.

Fact Sources

  • Tencent Cloud China API documentation: https://cloud.tencent.com/document/product/457/31864, page last updated 2025-11-06 02:18:04. Used as the primary source because the target document links to China-site API docs and the issue reports the China-site contract.
  • Tencent Cloud International API documentation: https://intl.cloud.tencent.com/pt/document/product/457/32038, page last updated 2026-05-27 13:00:09. Checked for comparison; it differs on whether InstanceDeleteMode is required, so this PR follows the China-site source for the China-site document.
  • Official TencentCloud Python SDK model: https://raw.githubusercontent.com/TencentCloud/tencentcloud-sdk-python/master/tencentcloud/tke/v20180525/models.py. Used to confirm request/response model field names.
  • Official TencentCloud Go SDK model: https://raw.githubusercontent.com/TencentCloud/tencentcloud-sdk-go/master/tencentcloud/tke/v20180525/models.go. Used to confirm request/response model field names.
  • Repository source: src/content/docs/basics/node/02-delete-node.md and local navigation references. Used to keep the change scoped to the requested document.

Static Compile

  • npm run build: passed.
  • node --test test/navigation.test.mjs test/cookbooks.test.mjs test/create-cluster-autoupgrade.test.mjs: passed, 10/10 tests.
  • python3 -m py_compile cookbook/common/auth.py cookbook/common/logger.py cookbook/cluster/create_cluster.py cookbook/cluster/delete_cluster.py cookbook/cluster/describe_clusters.py cookbook/supernode/deploy_gpu_pod.py cookbook/workload/deploy_nginx.py: passed.
  • git diff --check: passed.
  • mkdocs build --strict: skipped; no mkdocs.yml / mkdocs.yaml config exists in the repository.

Dry Run Compile

  • Checked all DeleteClusterInstances CLI and SDK examples in the target page for required ClusterId, InstanceIds, and InstanceDeleteMode.
  • Checked response handling text so readers do not treat RequestId alone as proof that node deletion completed.
  • No real Tencent Cloud resources were created, modified, or deleted.

Live Verify

  • Required: yes. This page documents a real TKE node deletion operation and should be validated by Live Verify before closure.

Remaining Human Confirmation

  • None for the documented API field names and examples. The China-site and International-site API pages differ on InstanceDeleteMode requiredness; the choice to follow China-site docs is intentional because this page links to China-site documentation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant