获取运行时实例 Webshell 连接地址。 ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=GetRuntimeWebshellEndpoint&groupName=Runtime&serviceCode=agentkit&version=2025-10-30) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：GetRuntimeWebshellEndpoint` 要执行的操作，取值：GetRuntimeWebshellEndpoint。 **Version** string 必选 `示例值：2025-10-30` API的版本，取值：2025\-10\-30。 **RuntimeId** string 必选 `示例值：r-ye7agye1a8cr38iu****` 运行时ID。 **InstanceName** string 必选 `示例值：1jsq6bcn-630g8l8****` 实例名称。可通过[ListRuntimeInstances](https://docs.volcengine.com/docs/86681/2169791)获取，实例必须处于 Ready 状态。 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **Endpoint** string `示例值：https://sf6u1gofl140096v5****.apigateway-cn-beijing.volceapi.com/terminal?faasInstanceName=vefaas-ano****-sandbox\u0026Authorization=kOh_BLxJ5IfRi572QL6GlliEeL4bX_9****` 运行时实例 Webshell 终端连接地址。 ## 请求示例 ```json POST https://agentkit.cn-beijing.volcengineapi.com?Action=GetRuntimeWebshellEndpoint&Version=2025-10-30 HTTP/1.1 Content-Type: application/json { "RuntimeId": "r-ye7agye1a8cr38iu****", "InstanceName": "1jsq6bcn-630g8l8****" } ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20260722101146160192149018500291", "Action": "GetRuntimeWebshellEndpoint", "Version": "2025-10-30", "Service": "agentkit", "Region": "cn-beijing" }, "Result": { "Endpoint": "https://sf6u1gofl140096v5****.apigateway-cn-beijing.volceapi.com/terminal?faasInstanceName=vefaas-ano****-sandbox\\u0026Authorization=kOh_BLxJ5IfRi572QL6GlliEeL4bX_9****" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/86681/1913777)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |MissingParameter.InstanceName |The required parameter InstanceName is not supplied. |参数实例名称不能为空。 | |400 |MissingParameter.RuntimeId |The required parameter RuntimeId is not supplied. |runtime id不能为空。 | |404 |InvalidAgentKitRuntime.NotFound |The specified AgentKitRuntime does not exist. |找不到对应的Runtime实例。 |