{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/umu9guqpk","result":{"data":{"markdownRemark":{"html":"

该接口用于将支持域名级生效范围的插件批量安装到服务域名，并同步相关网关实例的数据面插件配置。插件配置为空时使用插件定义中的默认配置。

\n

注意事项：

\n\n

请求结构

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /?action=InstallPluginToDomains HTTP/1.1\n2Host: apigw-control.bj.baidubce.com\n3Authorization: authorization string\n4\n5{\n6    "pluginId": pluginId,\n7    "serviceDomainIds" : [serviceDomainId],\n8    "pluginConfig": pluginConfig,\n9    "status": status\n10}
\n
\n
\n
\n \n

请求头域

\n

除公共头域外，无其它特殊头域。

\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称类型是否必需参数位置描述
pluginIdString是RequestBody参数插件 Release ID
serviceDomainIdsList<String>是RequestBody参数服务域名 ID 列表
pluginConfigString否RequestBody参数插件配置
statusString是RequestBody参数启用状态
\n

返回头域

\n

除公共头域，无其它特殊头域。

\n

返回参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称类型描述
pluginBindingIdsList<String>插件绑定 ID 列表
\n

错误码

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
错误码错误描述HTTP状态码中文解释
MethodArgumentNotValidExceptionMethodArgumentNotValidException: pluginId must not be blank400必填参数缺失或格式不合法，pluginId 不能为空
HttpMessageNotReadableHttp Message Not Readable: JSON parse error400请求体不是合法 JSON，无法解析，请检查 JSON 语法和字段类型
ResourcePermissionDenyResource permission deny.401无权限访问指定资源，请确认使用正确的账号凭证且资源属于当前账号
PluginReleaseNotExistPlugin release not exist.404插件 Release 不存在、不属于当前账号或已删除
HttpMediaTypeExceptionHttpMediaTypeException: Content-Type 'text/plain' is not supported415请求的 Content-Type 不受支持，请使用 application/json
DataPlaneSyncFailed配置已保存成功，但网关操作失败，请稍后重试或联系技术支持。500配置已写入控制面，但下发数据面失败，请稍后重试或联系技术支持
\n

请求示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /?action=InstallPluginToDomains HTTP/1.1\n2Host: apigw-control.bj.baidubce.com\n3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de\n4\n5{\n6    "pluginId": "pls-a1b2c3d4",\n7    "serviceDomainIds": [\n8        "dn-a1b2c3d4"\n9    ],\n10    "pluginConfig": "{}",\n11    "status": "Enabled"\n12}
\n
\n
\n
\n \n

返回示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1HTTP/1.1 200 OK\n2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50\n3Date: Wed, 03 Dec 2014 06:42:19 GMT\n4Content-Type: application/json;charset=UTF-8\n5Server: BWS\n6\n7{\n8    "pluginBindingIds": [\n9        "plugin_bind-a1b2c3d4"\n10    ]\n11}
\n
\n
\n
\n ","fields":{"slug":"umu9guqpk","title":"安装插件到域名","date":"2026-09-22","extractedHeadings":[]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"umu9guqpk","prev":{"id":"dmu9guqn8","name":"查询插件详情","path":"dmu9guqn8","filePath":"API网关专享版/API参考/插件相关接口/查询插件详情.md","seo":null,"parentIds":["Omspw9n4x","9mtlbl1tb","tmu9gupxs"],"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"9mtlbl1tb","documentId":"4a413222-fb8a-4a99-a3ad-3a8b027a3b08","name":"API参考","repoName":"APIGW","filePath":"API网关专享版/API参考","disabled":false,"path":"9mtlbl1tb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"tmu9gupxs","documentId":"9d70c2f0-c800-4276-98c9-eaa1baa9ea45","name":"插件相关接口","repoName":"APIGW","filePath":"API网关专享版/API参考/插件相关接口","disabled":false,"path":"tmu9gupxs","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"pmu9gur1a","name":"查询插件已安装域名列表","path":"pmu9gur1a","filePath":"API网关专享版/API参考/插件相关接口/查询插件已安装域名列表.md","seo":null,"parentIds":["Omspw9n4x","9mtlbl1tb","tmu9gupxs"],"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"9mtlbl1tb","documentId":"4a413222-fb8a-4a99-a3ad-3a8b027a3b08","name":"API参考","repoName":"APIGW","filePath":"API网关专享版/API参考","disabled":false,"path":"9mtlbl1tb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"tmu9gupxs","documentId":"9d70c2f0-c800-4276-98c9-eaa1baa9ea45","name":"插件相关接口","repoName":"APIGW","filePath":"API网关专享版/API参考/插件相关接口","disabled":false,"path":"tmu9gupxs","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"9mtlbl1tb","documentId":"4a413222-fb8a-4a99-a3ad-3a8b027a3b08","name":"API参考","repoName":"APIGW","filePath":"API网关专享版/API参考","disabled":false,"path":"9mtlbl1tb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"tmu9gupxs","documentId":"9d70c2f0-c800-4276-98c9-eaa1baa9ea45","name":"插件相关接口","repoName":"APIGW","filePath":"API网关专享版/API参考/插件相关接口","disabled":false,"path":"tmu9gupxs","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}