创建浏览器配置 - CreateCoreBrowserProfile
功能介绍
该API用于创建一个浏览器配置。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
URI
POST /v1/core/browser-profiles
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 是 | String | 参数解释: 浏览器配置的名称。 约束限制: 该名称在您的账户中必须是唯一的。 取值范围: 符合正则条件^[a-z][a-z0-9-]{0,38}[a-z0-9]$,即必须以小写字母开头,小写字母或数字结尾,中间可包含数字、小写字母、中划线,字符长度必须在2-40个字符之间。 默认取值: 不涉及。 |
| description | 否 | String | 参数解释: 浏览器配置的描述。 约束限制: 不涉及。 取值范围: 任意字符,长度不能超过4096个字符。 默认取值: 不涉及。 |
| tags | 否 | Array of CoreToolsTag objects | 参数解释: 资源标签。 约束限制: 同一个资源的标签key不能重复、标签列表最多支持20个。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| key | 是 | String | 参数解释: 标签键,不能为空且同一资源下标签键不能重复。 约束限制: 不涉及。 取值范围: 符合规则^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}.:/=+-@]*)(?<!\s)$,即可以包含任意语种的字母、数字和空格,以及.:=+-@字符,但首尾不能包含空格,且不能以_sys_开头,且长度在1到128之间。 默认取值: 不涉及。 |
| value | 是 | String | 参数解释: 标签值。 约束限制: 不涉及。 取值范围: 符合规则^([\p{L}\p{Z}\p{N}.:/=+-@]*)$,即可以包含任意语种的字母、数字和空格,以及.:/=+-@字符,且长度不能超过255个字符。 默认取值: 不涉及。 |
响应参数
状态码:201
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 浏览器配置ID。 取值范围: 符合UUID规则^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$的36位字符串。 |
| name | String | 参数解释: 浏览器配置的名称。 取值范围: 符合正则^[a-z][a-z0-9-]{0,38}[a-z0-9]$,即必须以小写字母开头,小写字母或数字结尾,中间可包含数字、小写字母、中划线,字符长度必须在2-40个字符之间。 |
| description | String | 参数解释: 浏览器配置的描述。 取值范围: 任意字符,长度不能超过4096个字符 |
| last_saved_browser_id | String | 参数解释: 最近保存的浏览器ID。 取值范围: 长度36到36个字符。 |
| last_saved_browser_name | String | 参数解释: 最近保存的浏览器名称。 取值范围: 长度1到64个字符。 |
| last_saved_browser_session_id | String | 参数解释: 最近保存的浏览器会话ID。 取值范围: 长度36到36个字符。 |
| last_saved_browser_session_name | String | 参数解释: 最近保存的浏览器会话名称。 取值范围: 长度1到128个字符。 |
| last_saved_at | String | 参数解释: 最近保存时间。 取值范围: ISO 8601日期时间格式字符串。 |
| tags | Array of CoreToolsTag objects | 参数解释: 资源标签。 取值范围: 数组长度0到20个元素。 |
| created_at | String | 参数解释: 创建时间。 取值范围: ISO 8601日期时间格式字符串。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| key | String | 参数解释: 标签键,不能为空且同一资源下标签键不能重复。 取值范围: 符合规则^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}.:/=+-@]*)(?<!\s)$,即可以包含任意语种的字母、数字和空格,以及.:=+-@字符,但首尾不能包含空格,且不能以_sys_开头,且长度在1到128之间。 |
| value | String | 参数解释: 标签值。 取值范围: 符合规则^([\p{L}\p{Z}\p{N}.:/=+-@]*)$,即可以包含任意语种的字母、数字和空格,以及.:/=+-@字符,且长度不能超过255个字符。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。 |
| encoded_authorization_message | String | 参数解释: 编码后的授权失败信息。 取值范围: 长度1到4096个字符。 |
| details | Array of CoreToolsCommonError objects | 参数解释: 依赖的下游服务错误信息列表。 取值范围: 数组长度0到10个元素。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。 |
状态码:409
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。 |
状态码:429
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。 |
请求示例
POST /v1/core/browser-profiles
{
"name" : "browser-profiles-demo",
"description" : "des"
} 响应示例
状态码:201
创建成功。
{
"id" : "306b7c12-a069-4b3e-9c1d-692f010cc37b",
"name" : "browser-profiles-demo",
"description" : "des",
"created_at" : "2022-11-09 16:37:24"
} 状态码:400
请求参数错误。
{
"error_code" : "AgentArts.04000400",
"error_msg" : "Invalid parameter."
} 状态码:401
认证失败。
{
"error_code" : "AgentArts.04000401",
"error_msg" : "Authentication failed: invalid token."
} 状态码:403
权限不足。
{
"error_code" : "AgentArts.04000403",
"error_msg" : "Authentication failed: you have no permission of XXX",
"encoded_authorization_message" : "eyJlcnJvciI6ICJVbmF1dGhvcml6ZWQifQ==",
"details" : [ {
"error_code" : "AgentArts.04000403",
"error_msg" : "Authentication failed."
} ]
} 状态码:404
资源不存在。
{
"error_code" : "AgentArts.04000404",
"error_msg" : "resource xxx not exist"
} 状态码:409
操作冲突。
{
"error_code" : "AgentArts.04000409",
"error_msg" : "operation conflict"
} 状态码:429
请求频率超限。
{
"error_code" : "AgentArts.04000429",
"error_msg" : "The interface has been limited."
} 状态码:500
内部系统错误。
{
"error_code" : "AgentArts.04000500",
"error_msg" : "Internal error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 201 | 创建成功。 |
| 400 | 请求参数错误。 |
| 401 | 认证失败。 |
| 403 | 权限不足。 |
| 404 | 资源不存在。 |
| 409 | 操作冲突。 |
| 429 | 请求频率超限。 |
| 500 | 内部系统错误。 |
错误码
请参见错误码。