1. 接口描述
接口请求域名: dlc.tencentcloudapi.com 。
获取Pod的YAML内容
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:GetRayJobPodYaml。 |
| Version | 是 | String | 公共参数,本接口取值:2021-01-25。 |
| Region | 是 | String | 公共参数,详见产品支持的 地域列表,本接口仅支持其中的: ap-beijing, ap-chongqing, ap-guangzhou, ap-shanghai, ap-singapore 。 |
| Id | 否 | String | 任务ID 示例值:rayjob-20260323163852-huvy |
| PodName | 否 | String | Pod名称 示例值:rayjob-20260323163852-huvy-8qd7h |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Yaml | String | Pod Yaml 示例值:Pod not found: rayjob |
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 获取Pod的YAML内容
输入示例
POST / HTTP/1.1
Host: dlc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: GetRayJobPodYaml
<公共请求参数>
{
"Id": "rayjob-20260323163852-huvy",
"PodName": "rayjob-20260323163852-huvy-8qd7h"
}
输出示例
{
"Response": {
"Yaml": "---\napiVersion: \"v1\"\nkind: \"Pod\"\nmetadata:\n annotations:\n eks.tke.cloud.tencent.com/cluster-ip-switch: \"cluster\"\n tke.cloud.tencent.com/pod-type: \"eklet\"\n creationTimestamp: \"2026-03-23T08:46:30Z\"\n generateName: \"rayjob-20260323163852-huvy-\"\n labels:\n batch.kubernetes.io/controller-uid: \"0b63da59-fc54-4a51-9b98-9bd82b9debd9\"\n batch.kubernetes.io/job-name: \"rayjob-20260323163852-huvy\"\n controller-uid: \"0b63da59-fc54-4a51-9b98-9bd82b9debd9\"\n job-name: \"rayjob-20260323163852-huvy\"\n name: \"rayjob-20260323163852-huvy-8qd7h\"\n namespace: \"dlc-p-ofvhyjzn\"\n ownerReferences:\n - apiVersion: \"batch/v1\"\n kind: \"Job\"\n blockOwnerDeletion: true\n controller: true\n name: \"rayjob-20260323163852-huvy\"\n uid: \"0b63da59-fc54-4a51-9b98-9bd82b9debd9\"\n resourceVersion: \"24376457730\"\n uid: \"d241ee9c-a8d2-4130-a9db-5d1ab4e5662f\"\nspec:\n containers:\n - args:\n - \"if ! ray job status --address http://rayjob-20260323163852-huvy-rvrkk-head-svc.dlc-p-ofvhyjzn.svc.cluster.local:8265\\\n \\ rayjob-20260323163852-huvy-pc9q7 >/dev/null 2>&1 ; then ray job submit --address\\\n \\ http://rayjob-20260323163852-huvy-rvrkk-head-svc.dlc-p-ofvhyjzn.svc.cluster.local:8265\\\n \\ --no-wait --submission-id rayjob-20260323163852-huvy-pc9q7 -- sleep 100 ;\\\n \\ fi ; ray job logs --address http://rayjob-20260323163852-huvy-rvrkk-head-svc.dlc-p-ofvhyjzn.svc.cluster.local:8265\\\n \\ --follow rayjob-20260323163852-huvy-pc9q7\"\n command:\n - \"/bin/bash\"\n - \"-ce\"\n - \"--\"\n env:\n - name: \"PYTHONUNBUFFERED\"\n value: \"1\"\n - name: \"RAY_DASHBOARD_ADDRESS\"\n value: \"rayjob-20260323163852-huvy-rvrkk-head-svc.dlc-p-ofvhyjzn.svc.cluster.local:8265\"\n - name: \"RAY_JOB_SUBMISSION_ID\"\n value: \"rayjob-20260323163852-huvy-pc9q7\"\n image: \"ccr.ccs.tencentyun.com/emr-image/tcray:3.0.0.dev0-py311-cpu\"\n imagePullPolicy: \"IfNotPresent\"\n name: \"ray-job-submitter\"\n resources:\n limits:\n cpu: \"1\"\n memory: \"1Gi\"\n tke.cloud.tencent.com/eni-ip: \"1\"\n requests:\n cpu: \"500m\"\n memory: \"200Mi\"\n tke.cloud.tencent.com/eni-ip: \"1\"\n terminationMessagePath: \"/dev/termination-log\"\n terminationMessagePolicy: \"File\"\n volumeMounts:\n - mountPath: \"/var/run/secrets/kubernetes.io/serviceaccount\"\n name: \"kube-api-access-tbp5d\"\n readOnly: true\n dnsPolicy: \"ClusterFirst\"\n enableServiceLinks: true\n nodeName: \"eklet-subnet-l8wxf43i-bd9cv4ef\"\n preemptionPolicy: \"PreemptLowerPriority\"\n priority: 0\n restartPolicy: \"Never\"\n schedulerName: \"default-scheduler\"\n securityContext: {}\n serviceAccount: \"default\"\n serviceAccountName: \"default\"\n terminationGracePeriodSeconds: 30\n tolerations:\n - effect: \"NoExecute\"\n key: \"node.kubernetes.io/not-ready\"\n operator: \"Exists\"\n tolerationSeconds: 300\n - effect: \"NoExecute\"\n key: \"node.kubernetes.io/unreachable\"\n operator: \"Exists\"\n tolerationSeconds: 300\n volumes:\n - name: \"kube-api-access-tbp5d\"\n projected:\n defaultMode: 420\n sources:\n - serviceAccountToken:\n expirationSeconds: 3607\n path: \"token\"\n - configMap:\n items:\n - key: \"ca.crt\"\n path: \"ca.crt\"\n name: \"kube-root-ca.crt\"\n - downwardAPI:\n items:\n - fieldRef:\n apiVersion: \"v1\"\n fieldPath: \"metadata.namespace\"\n path: \"namespace\"\nstatus:\n containerStatuses:\n - containerID: \"containerd://fee08a4840c90df7ca68a0d4e745f4a2fa2a7848ebd99d620a0868d38f98ef97\"\n image: \"ccr.ccs.tencentyun.com/emr-image/tcray:3.0.0.dev0-py311-cpu\"\n imageID: \"ccr.ccs.tencentyun.com/emr-image/tcray@sha256:b429892e1f4790b5889c902e75a3fe3251cd164cfb352c62b3529066e4581b4d\"\n lastState: {}\n name: \"ray-job-submitter\"\n ready: false\n restartCount: 0\n started: false\n state:\n terminated:\n containerID: \"containerd://fee08a4840c90df7ca68a0d4e745f4a2fa2a7848ebd99d620a0868d38f98ef97\"\n exitCode: 0\n finishedAt: \"2026-03-23T08:54:20Z\"\n reason: \"Completed\"\n startedAt: \"2026-03-23T08:52:29Z\"\n hostIP: \"30.1.0.150\"\n phase: \"Succeeded\"\n podIP: \"30.1.0.150\"\n podIPs:\n - ip: \"30.1.0.150\"\n qosClass: \"Burstable\"\n startTime: \"2026-03-23T08:47:40Z\"\n",
"RequestId": "0acad9c8-2350-4a6f-a7a6-c04b4c0ba270"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.ExternalService | 外部服务异常 |