PolarisMesh
  1. 配置文件
PolarisMesh
PolarisMesh
  • PolarisMesh
  • 命名空间
    • 批量创建命名空间
      POST
    • 批量更新命名空间
      PUT
    • 批量删除命名空间
      POST
    • 获取命名空间列表
      GET
  • 注册发现
    • 服务
      • 批量创建服务
      • 批量删除服务
      • 获取服务列表
      • 批量更新服务
      • 获取全部的服务名称列表
      • 创建服务别名
      • 更新服务别名
      • 批量删除服务别名
      • 获取服务别名列表
    • 服务实例
      • 批量创建服务实例
      • 批量更新服务实例
      • 批量删除服务实例
      • 根据IP批量删除服务实例
      • 根据IP批量隔离服务实例
      • 获取服务实例列表
      • 获取某个服务下的所有实例标签
      • 获取当前北极星集群下的所有服务实例总数
      • 获取多个服务下的所有实例标签
    • 服务契约
      • 批量创建服务契约定义
      • 获取服务契约定义列表
      • 获取服务契约定义版本列表
      • 批量删除服务契约定义
      • 覆盖创建某个服务契约下的接口列表信息数据
      • 覆盖追加某个服务契约下的接口列表信息数据
      • 删除某个服务契约下的部份接口列表信息数据
      • 获取服务接口列表
  • 服务治理
    • 路由规则
      • 批量创建路由规则
      • 批量更新路由规则
      • 批量启用/禁用路由规则
      • 批量删除路由规则
      • 查询路由规则
      • 导出路由规则
      • 导入路由规则
    • 限流规则
      • 批量创建限流规则
      • 批量更新限流规则
      • 批量启用/禁用限流规则
      • 批量删除限流规则
      • 获取限流规则列表
      • 导出限流规则列表
      • 导入限流规则列表
    • 熔断规则
      • 批量创建熔断规则
      • 批量更新熔断规则
      • 批量启用/禁用熔断规则
      • 批量删除熔断规则
      • 获取熔断规则列表
      • 导出熔断规则
      • 导入熔断规则
    • 探测规则
      • 批量创建主动探测规则
      • 批量更新主动探测规则
      • 批量删除主动探测规则
      • 获取主动探测规则列表
    • 泳道规则
      • 批量创建泳道组
      • 批量更新泳道组
      • 批量删除泳道组
      • 查询泳道组列表
  • 配置中心
    • 配置分组
      • 创建配置分组
      • 更新配置分组
      • 删除配置分组
      • 获取配置分组列表
    • 配置文件
      • 创建配置文件
        POST
      • 更新配置文件
        PUT
      • 删除配置文件
        DELETE
      • 批量删除配置文件
        POST
      • 创建/更新配置文件并发布
        POST
      • 查询某个配置分组下的所有配置文件
        GET
      • 查询配置文件列表
        GET
      • 导出配置文件
        POST
      • 导入配置文件
        POST
      • 查询单个配置文件
        GET
    • 配置发布
      • 配置发布
      • 获取配置发布版本列表
      • 获取某个配置文件的发布版本列表
      • 回滚配置到某次发布
      • 删除某个配置发布
      • 获取某个发布的具体详细信息
      • 停止某个配置灰度发布
    • 配置历史
      • 获取配置发布历史
  • 用户/鉴权
    • 用户
      • 修改用户密码
      • 批量创建用户
      • 更新用户
      • 获取用户列表
      • 登陆
      • 启用/禁用用户资源访问Token
      • 重置用户资源访问Token
      • 获取用户Token
      • 批量删除用户
    • 用户组
      • 创建用户组
      • 删除用户组中的用户
      • 获取用户组列表
      • 获取用户组详细
      • 获取用户组资源访问Token
      • 重置用户组资源访问Token
      • 启用/禁用用户组资源访问Token
      • 更新用户组
    • 鉴权策略
      • 创建鉴权策略
      • 更新鉴权策略
      • 删除鉴权策略
      • 获取策略列表
      • 获取用户/用户组可操作资源列表
      • 获取鉴权策略详细
    • 角色
      • 批量创建角色
      • 批量更新角色
      • 批量删除角色
      • 查询角色列表
  • SDK接口
    • 服务治理
      • 注册服务实例
      • 反注册服务实例
      • 实例心跳上报
      • 获取服务列表
      • 获取服务实例列表
      • 获取限流规则
      • 获取熔断规则
      • 获取自定义路由规则
      • 获取就近路由规则
      • 获取主动探测规则
      • 获取服务契约信息
    • 配置中心
      • 获取客户端可见的发布
      • 客户端监听配置文件
      • 获取配置分组下已发布的配置文件名称列表
  • 运维管理
    • 获取日志输出级别
    • 设置日志输出级别
    • 获取存储层Leader列表
    • 获取CMDB插件信息
    • 获取所有北极星SDK实例信息
    • 获取实例的最后一次心跳数据
    • 查询服务端的接口列表名称信息
  • 历史-v1.18.x
    • 命名空间
      • 批量创建命名空间
      • 批量更新命名空间
      • 批量删除命名空间
      • 获取命名空间列表
    • 注册发现
      • 服务
        • 获取全部的服务名称列表
        • 创建服务别名
        • 更新服务别名
        • 批量删除服务别名
        • 获取服务别名列表
        • 批量创建服务
        • 批量删除服务
        • 获取服务列表
        • 批量更新服务
      • 服务实例
        • 批量创建服务实例
        • 批量更新服务实例
        • 批量删除服务实例
        • 根据IP批量删除服务实例
        • 根据IP批量隔离服务实例
        • 获取服务实例列表
        • 获取某个服务下的所有实例标签
        • 获取当前北极星集群下的所有服务实例总数
        • 获取多个服务下的所有实例标签
      • 服务契约
        • 批量创建服务契约定义
        • 获取服务契约定义列表
        • 获取服务契约定义版本列表
        • 批量删除服务契约定义
        • 覆盖创建某个服务契约下的接口列表信息数据
        • 覆盖追加某个服务契约下的接口列表信息数据
        • 删除某个服务契约下的部份接口列表信息数据
        • 获取服务接口列表
    • 服务治理
      • 路由规则
        • 批量创建路由规则
        • 批量更新路由规则
        • 批量启用/禁用路由规则
        • 批量删除路由规则
        • 查询路由规则
        • 导出路由规则
        • 导入路由规则
      • 限流规则
        • 批量创建限流规则
        • 批量更新限流规则
        • 批量启用/禁用限流规则
        • 批量删除限流规则
        • 获取限流规则列表
        • 导出限流规则列表
        • 导入限流规则列表
      • 熔断规则
        • 批量创建熔断规则
        • 批量更新熔断规则
        • 批量启用/禁用熔断规则
        • 批量删除熔断规则
        • 获取熔断规则列表
        • 导出熔断规则
        • 导入熔断规则
      • 探测规则
        • 批量创建主动探测规则
        • 批量更新主动探测规则
        • 批量删除主动探测规则
        • 获取主动探测规则列表
      • 泳道规则
        • 批量创建泳道组
        • 批量更新泳道组
        • 批量删除泳道组
        • 查询泳道组列表
    • 配置中心
      • 配置分组
        • 创建配置分组
        • 更新配置分组
        • 删除配置分组
        • 获取配置分组列表
      • 配置文件
        • 创建配置文件
        • 更新配置文件
        • 删除配置文件
        • 批量删除配置文件
        • 创建/更新配置文件并发布
        • 查询某个配置分组下的所有配置文件
        • 查询配置文件列表
        • 导出配置文件
        • 导入配置文件
        • 查询单个配置文件
      • 配置发布
        • 配置发布
        • 更新配置发布
        • 获取配置发布版本列表
        • 获取某个配置文件的发布版本列表
        • 回滚配置到某次发布
        • 删除某个配置发布
        • 获取某个发布的具体详细信息
        • 停止某个配置灰度发布
      • 配置历史
        • 获取配置发布历史
    • 用户/鉴权
      • 用户
        • 修改用户密码
        • 批量创建用户
        • 更新用户
        • 获取用户列表
        • 登陆
        • 启用/禁用用户资源访问Token
        • 重置用户资源访问Token
        • 获取用户Token
        • 批量删除用户
      • 用户组
        • 创建用户组
        • 删除用户组中的用户
        • 获取用户组列表
        • 获取用户组详细
        • 获取用户组资源访问Token
        • 重置用户组资源访问Token
        • 启用/禁用用户组资源访问Token
        • 更新用户组
      • 鉴权策略
        • 创建鉴权策略
        • 更新鉴权策略
        • 删除鉴权策略
        • 获取策略列表
        • 获取用户/用户组可操作资源列表
        • 获取鉴权策略详细
    • SDK接口
      • 服务治理
        • 注册服务实例
        • 反注册服务实例
        • 实例心跳上报
        • SDK接口-服务列表获取
        • SDK接口-服务实例获取
        • SDK接口-限流规则获取
        • SDK接口-熔断规则获取
        • SDK接口-自定义路由规则获取
        • SDK接口-就近路由规则获取
        • SDK接口-主动探测规则获取
        • 获取服务契约信息
      • 配置中心
        • 获取客户端可见的发布
        • 客户端监听配置文件
        • 获取配置分组下已发布的配置文件名称列表
    • 运维管理
      • 获取日志输出级别
      • 设置日志输出级别
      • 获取存储层Leader列表
      • 获取CMDB插件信息
      • 获取所有北极星SDK实例信息
      • 获取实例的最后一次心跳数据
  • 历史-v1.17.x
    • 命名空间
      • 批量创建命名空间
      • 批量更新命名空间
      • 批量删除命名空间
      • 获取命名空间列表
    • 注册发现
      • 服务
        • 获取全部的服务名称列表
        • 创建服务别名
        • 更新服务别名
        • 批量删除服务别名
        • 获取服务别名列表
        • 批量创建服务
        • 批量删除服务
        • 获取服务列表
        • 批量更新服务
      • 服务实例
        • 批量创建服务实例
        • 批量更新服务实例
        • 批量删除服务实例
        • 根据IP批量删除服务实例
        • 根据IP批量隔离服务实例
        • 获取服务实例列表
        • 获取某个服务下的所有实例标签
        • 获取当前北极星集群下的所有服务实例总数
        • 获取多个服务下的所有实例标签
      • 服务契约
        • 批量创建服务契约定义
        • 获取服务契约定义列表
        • 获取服务契约定义版本列表
        • 批量删除服务契约定义
        • 覆盖创建某个服务契约下的接口列表信息数据
        • 覆盖追加某个服务契约下的接口列表信息数据
        • 删除某个服务契约下的部份接口列表信息数据
        • 获取服务接口列表
    • 服务治理
      • 路由规则
        • 批量创建路由规则
        • 批量更新路由规则
        • 批量启用/禁用路由规则
        • 批量删除路由规则
        • 查询路由规则
        • 导出路由规则
        • 导入路由规则
      • 限流规则
        • 批量创建限流规则
        • 批量更新限流规则
        • 批量启用/禁用限流规则
        • 批量删除限流规则
        • 获取限流规则列表
        • 导出限流规则列表
        • 导入限流规则列表
      • 熔断规则
        • 批量创建熔断规则
        • 批量更新熔断规则
        • 批量启用/禁用熔断规则
        • 批量删除熔断规则
        • 获取熔断规则列表
        • 导出熔断规则
        • 导入熔断规则
      • 探测规则
        • 批量创建主动探测规则
        • 批量更新主动探测规则
        • 批量删除主动探测规则
        • 获取主动探测规则列表
      • 泳道规则
        • 批量创建泳道组
        • 批量更新泳道组
        • 批量删除泳道组
        • 查询泳道组列表
    • 配置中心
      • 配置分组
        • 创建配置分组
        • 更新配置分组
        • 删除配置分组
        • 获取配置分组列表
      • 配置文件
        • 创建配置文件
        • 更新配置文件
        • 删除配置文件
        • 批量删除配置文件
        • 创建/更新配置文件并发布
        • 查询某个配置分组下的所有配置文件
        • 查询配置文件列表
        • 导出配置文件
        • 导入配置文件
        • 查询单个配置文件
      • 配置发布
        • 配置发布
        • 更新配置发布
        • 获取配置发布版本列表
        • 获取某个配置文件的发布版本列表
        • 回滚配置到某次发布
        • 删除某个配置发布
        • 获取某个发布的具体详细信息
        • 停止某个配置灰度发布
      • 配置历史
        • 获取配置发布历史
    • 用户/鉴权
      • 用户
        • 修改用户密码
        • 批量创建用户
        • 更新用户
        • 获取用户列表
        • 登陆
        • 启用/禁用用户资源访问Token
        • 重置用户资源访问Token
        • 获取用户Token
        • 批量删除用户
      • 用户组
        • 创建用户组
        • 删除用户组中的用户
        • 获取用户组列表
        • 获取用户组详细
        • 获取用户组资源访问Token
        • 重置用户组资源访问Token
        • 启用/禁用用户组资源访问Token
        • 更新用户组
      • 鉴权策略
        • 创建鉴权策略
        • 更新鉴权策略
        • 删除鉴权策略
        • 获取策略列表
        • 获取用户/用户组可操作资源列表
        • 获取鉴权策略详细
    • SDK接口
      • 服务治理
        • 注册服务实例
        • 反注册服务实例
        • 实例心跳上报
        • SDK接口-服务列表获取
        • SDK接口-服务实例获取
        • SDK接口-限流规则获取
        • SDK接口-熔断规则获取
        • SDK接口-自定义路由规则获取
        • SDK接口-就近路由规则获取
        • SDK接口-主动探测规则获取
        • 获取服务契约信息
      • 配置中心
        • 获取客户端可见的发布
        • 客户端监听配置文件
        • 获取配置分组下已发布的配置文件名称列表
    • 运维管理
      • 获取日志输出级别
      • 设置日志输出级别
      • 获取存储层Leader列表
      • 获取CMDB插件信息
      • 获取所有北极星SDK实例信息
      • 获取实例的最后一次心跳数据
  1. 配置文件

创建配置文件

POST
/config/v1/configfiles
最后修改时间:2025-03-07 07:07:43
责任人:未设置

请求参数

Header 参数
X-Polaris-Token
string 
可选
鉴权凭据,当OpenAPI接口鉴权开启时必须开启
Body 参数application/json
namespace
string 
命名空间
必需
group
string 
配置分组名称
必需
name
string 
配置文件名称
必需
format
string 
配置文件内容格式
可选
comment
string 
配置文件描述
可选
content
string 
配置文件内容
可选
不传入则为空字符串
encrypt_algo
string 
加密算法
可选
encrypted
boolean 
是否开启加密,默认不开启
可选
tags
array [object {2}] 
配置文件标签
可选
key
string 
标签 key
可选
value
string 
标签 value
可选
supported_client
string 
支持客户端类型
可选
CLIENT_SDK = 0; // 配置文件仅能被SDK拉取 CLIENT_AGENT = 1; // 配置文件仅能被Agent拉取 CLIENT_ALL = 2; // 配置文件可以被SDK及Agent同时拉取
persistent
object 
可选
encoding
string 
编码模式
必需
path
string 
下发路径
必需
postCmd
string 
下发命令
必需
示例
{
    "namespace": "default",
    "group": "GROUP-123",
    "name": "application.yaml",
    "content": "coffees: [ \"Latte\", \"Cappuccino\", \"Espresso\"]",
    "comment": "config for test",
    "format": "yaml",
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        }
    ],
    "supported_client": "CLIENT_AGENT",
    "persistent": {
    "encoding": "UTF-8",
    "path": "/tmp/cody",
    "postCmd": "echo aaa;\n echo ccc"
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://119.91.66.223:8090/config/v1/configfiles' \
--header 'X-Polaris-Token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "namespace": "default",
    "group": "GROUP-123",
    "name": "application.yaml",
    "content": "coffees: [ \"Latte\", \"Cappuccino\", \"Espresso\"]",
    "comment": "config for test",
    "format": "yaml",
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        }
    ],
    "supported_client": "CLIENT_AGENT",
    "persistent": {
    "encoding": "UTF-8",
    "path": "/tmp/cody",
    "postCmd": "echo aaa;\n echo ccc"
    }
}'

返回响应

🟢200成功
application/json
Body
code
integer 
状态码
可选
info
string 
提示信息
可选
configFile
object 
配置文件
可选
id
integer 
配置文件ID
可选
namespace
string 
命名空间
可选
group
string 
配置分组名称
可选
name
string 
配置文件名称
可选
format
string 
配置文件内容格式
可选
comment
string 
配置文件描述
可选
content
string 
配置文件内容
可选
tags
array [object {2}] 
配置文件标签
可选
supported_client
string 
支持客户端类型
可选
CLIENT_SDK = 0; // 配置文件仅能被SDK拉取 CLIENT_AGENT = 1; // 配置文件仅能被Agent拉取 CLIENT_ALL = 2; // 配置文件可以被SDK及Agent同时拉取
persistent
object 
可选
示例
{
    "code": 200000,
    "info": "execute success",
    "configFile": {
        "id": 1,
        "name": "application.yaml",
        "namespace": "default",
        "group": "GROUP-123",
        "content": "coffees: [ \"Latte\", \"Cappuccino\", \"Espresso\"]",
        "format": "yaml",
        "comment": "config for test",
        "tags": [
            {
                "key": "key1",
                "value": "value1"
            }
        ],
        "supported_client": "CLIENT_AGENT",
        "persistent": {
            "encoding": "UTF-8",
            "path": "/tmp/cody",
            "postCmd": "echo aaa;\n echo ccc"
        }
    }
}
修改于 2025-03-07 07:07:43
上一页
获取配置分组列表
下一页
更新配置文件
Built with