更新网关实例配置 UpdateAIGatewayInstance--全站加速-火山引擎

文档中心

全站加速

AI 加速网关接口

更新网关实例配置 UpdateAIGatewayInstance

更新指定 AI 加速网关实例的配置。可修改模型列表、路由策略、高级配置（加速、缓存、限流、预算、工具过滤）、名称、描述和标签。

使用限制

节流限制：您每秒最多可以提交 20 个 API 请求。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=UpdateAIGatewayInstance&Version=2021-04-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `UpdateAIGatewayInstance`。
Version	String	是	接口版本。当前 API 的版本为 `2021-04-01`。

Body

参数名称	数据类型	是否必选	参数说明	示例
ID	String	是	AI 加速网关实例的唯一标识。可通过 `ListAIGatewayInstance` 接口获取。	`ga-123456789`
Name	String	否	实例名称。用于在控制台和列表中识别该实例，建议使用可读且唯一的名称。	`my-maas-gateway`
MaasAPI	Object	否	模型服务配置。包含接入的模型列表和路由策略。
Advanced	Object	否	高级配置。包含加速、缓存、限流等配置项。
Description	String	否	实例的描述信息。用于备注该实例的用途或业务场景。	`生产环境文本生成网关`
Project	String	否	实例所属的项目名称。用于按项目维度进行资源管理和权限隔离。	`default`
Tags	Object[]	否	实例的标签列表。用于对实例进行分类和筛选管理。

返回参数

请求示例

POST https://open.volcengineapi.com?Action=UpdateAIGatewayInstance&Version=2021-04-01
{
    "Advanced": {
        "Acceleration": {
            "Domain": "my-maas-gateway.aig.volcdngateway.com",
            "Enabled": true,
            "Modified": 1700000000,
            "Scope": "domestic",
            "Status": "",
            "Error": ""
        },
        "Cache": {
            "Config": {
                "Mode": 1,
                "TTL": 3600
            },
            "Enabled": true
        },
        "Limit": {
            "Enabled": false
        }
    },
    "Description": "生产环境文本生成网关",
    "ID": "ga-123456789",
    "MaasAPI": {
        "Models": [
            {
                "APIKey": "****",
                "BaseURL": "https://ark.cn-beijing.volces.com/api/v3",
                "Category": "chat",
                "ID": "ga-123456789",
                "Model": "doubao-seed-2-0-mini-260215",
                "Protocol": 1,
                "Provider": "bytedance",
                "Source": 1,
                "Weight": 50
            }
        ],
        "RoutePolicies": {
            "Fallback": {
                "Enabled": true
            },
            "LB": {
                "Enabled": true
            }
        }
    },
    "Name": "my-maas-gateway",
    "Project": "default",
    "Tags": [
        {
            "Value": "production",
            "Key": "env"
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "UpdateAIGatewayInstance",
        "Version": "2021-04-01",
        "Service": "dcdn",
        "Region": "cn-north-1"
    }
}

最近更新时间：2026.06.03 17:04:35

这个页面对您有帮助吗？

有用

无用

全站加速

使用限制 #

请求说明 #

调试 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #