创建仓库文件推送权限
功能介绍
创建仓库文件推送权限
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v4/repositories/{repository_id}/file-push-permissions
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
repository_id |
是 |
Integer |
参数解释: 仓库的ID,通过查询用户所有仓库接口查询项目列表获取。 约束限制: 不涉及。 取值范围: 1-2147483647 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
path |
是 |
String |
参数解释: 目录路径或通配符 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
actions |
否 |
Array of FilePushPermissionActionBodyDto objects |
参数解释: 事件设置列表 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
enable |
否 |
Boolean |
参数解释: 是否启用。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 默认取值: true |
user_ids |
否 |
Array of objects |
参数解释: 用户ID列表。 约束限制: 不涉及。 取值范围: Integer 默认取值: 不涉及。 取值范围: 1-2147483647 |
user_team_ids |
否 |
Array of integers |
参数解释: 成员组ID列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 取值范围: 1-2147483647 |
related_role_ids |
否 |
Array of strings |
参数解释: 关联角色ID列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
action |
否 |
String |
参数解释: 事件名称。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 枚举值:
|
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
id |
Integer |
参数解释: 仓库文件推送权限ID。 取值范围: 1-2147483647 取值范围: 1-2147483647 |
path |
String |
参数解释: 目录路径或通配符。 取值范围: 不涉及。 |
actions |
Array of RepositoryProtectedActionDto objects |
参数解释: 事件列表。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
action |
String |
参数解释: 事件名称。 取值范围: 不涉及。 |
enable |
Boolean |
参数解释: 是否启用。 取值范围:
|
users |
Array of RepositoryUserDto objects |
参数解释: 白名单用户列表。 取值范围: 不涉及。 |
user_teams |
Array of UserTeamBasicDto objects |
参数解释: 白名单用户组列表。 取值范围: 不涉及。 |
roles |
Array of BasicRoleDto objects |
参数解释: 白名单角色列表。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
Integer |
参数解释: 用户id。 取值范围: 1-2147483647 |
name |
String |
参数解释: 用户名称。 |
username |
String |
参数解释: 用户名。 |
state |
String |
参数解释: 用户状态。 取值范围: 不涉及。 |
avatar_url |
String |
参数解释: 头像地址。 取值范围: 不涉及。 |
nick_name |
String |
参数解释: 用户昵称。 取值范围: 不涉及。 |
tenant_name |
String |
参数解释: 所属租户名称。 取值范围: 不涉及。 |
请求示例
创建仓库文件推送权限
POST /v4/repositories/123/file-push-permissions { "path" : "/config1/*", "actions" : [ { "action" : "push", "enable" : true, "user_ids" : [ 9124 ], "user_team_ids" : [ 247 ], "related_role_ids" : [ "6115a3ddd9044e288c558d1ae827a732" ] } ] }
响应示例
状态码:200
仓库文件推送权限
{ "id" : 44, "path" : "33", "actions" : [ { "action" : "push", "enable" : true, "users" : [ { "id" : 7574, "name" : "user", "username" : "a618e34bd5704be3ae3395dfede06041", "state" : "active", "avatar_url" : "", "nick_name" : "user", "tenant_name" : "tenant" } ], "user_teams" : [ { "id" : 247, "name" : "team-1" } ], "roles" : [ { "id" : 23836594, "name" : "Project manager", "related_role_id" : "6115a3ddd9044e288c558d1ae827a732", "chinese_name" : "项目经理" } ] } ] }
状态码
状态码 |
描述 |
---|---|
200 |
仓库文件推送权限 |
错误码
请参见错误码。