接口说明
请确保在使用该接口前，已充分了解EAS产品的收费方式和价格。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI
Explorer可以自动生成SDK代码示例。
调试
调试
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| eas:CreateService | Write |
|
|
无 |
请求语法
POST /api/v2/services
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| body | string | 否 |
请求body，具体的参数配置说明，请参见下方的请求参数补充说明。 |
{ “name”: “foo”, “model_path”: “http://path/to/model.tar.gz”, “processor”: “tensorflow_cpu”, “metadata”: { “instance”: 2, “memory”: 7000, “cpu”: 4 } } |
| Develop | string | 否 |
是否进入开发模式。 枚举值：
|
true |
| Labels | object | 否 |
用户自定义标签。 |
|
| string | 否 |
标签。 |
{“key”:”value”} | |
| WorkspaceId | string | 否 |
工作空间ID |
123456 |
表 1. 请求Body参数
| 名称 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| name | String | 是 | 服务名称，在同一个地域内全局唯一。 |
| token | String | 否 | 指定用于访问鉴权的Token字符串，若不指定则按generate_token自动生成。 |
| model_path | String | 否 | 模型相关的文件，支持HTTP和OSS两种格式，HTTP地址需为Public可访问的。若为OSS地址，则输入可以是目录或者文件；若文件为.tar.gz、.tar.bz2、.zip等压缩包，会自动解压。 |
| role_arn | string | 否 | model_path或processor_path为OSS地址时，需要指定用于OSS授权的role_arn，role_arn的获取参数Role_ARN。 |
| oss_endpoint | String | 否 | model_path或processor_path为OSS地址时，需要指定OSS Bucket对应的endpoint。 |
| model_entry | String | 否 | 模型的入口文件，若不指定，则使用model_path中的文件名，可以包含任意文件，主文件的路径会传递给Processor中的Load()函数。 |
| processor_path | String | 是 | Processor相关的文件包，支持本地文件和HTTP链接地址，若文件为.tar.gz、.tar.bz2、.zip等压缩包，会自动解压。 |
| processor_entry | String | 否 | C、C++、Python类型必选。Processor的主文件，其中包含了预测所需要Load()函数和Process()函数的实现。 |
| processor_mainclass | String | 否 | Java类型必选。Processor的主文件，JAR包中的mainclass。 |
| processor_type | String | 是 | processor实现的语言，目前已支持C、C++、Java、Python。 |
| metadata | Dict | 否 | 服务的meta信息。详见下表2。 |
| cloud | Dict | 否 | 目前只有指定机型部署时会用到，传参的样式为"cloud":{"computing":{"instance_type": "ecs.gxxxxxx.large"}}。 |
| containers | List | 否 | 自定义镜像部署。如果Processor部署无法满足需求，可以使用自定义镜像部署，详情请参见服务部署：自定义镜像。 |
说明
model_path和processor_path为输入模型数据和processor数据的数据来源，支持HTTP和OSS两种数据源，使用test命令进行本地调试时支持本地文件和目录。
- 若使用HTTP地址，则需要将相关文件打包成.tar.gz、.tar.bz2、.zip等压缩包，可上传至OSS并生成HTTP地址。
- 若使用OSS地址，则输入可以是目录，也可以是文件。
表 2. metadata参数
| 名称 | 类型 | 是否必选 | 描述 | 示例值 |
|---|---|---|---|---|
| instance | Int | 否 | 服务启动的Worker数目。 | 1 |
| cpu | Int | 否 | 每个Worker需要的CPU数目。 | 1 |
| gpu | Int | 否 | 每个Worker需要的GPU数目。 | 0 |
| memory | Int | 否 | 每个Worker需要的内存大小，单位为MB。 | 1000 |
| resource | String | 否 | 服务所属的资源组。 | eas-r-aaabbbccc |
| rpc.worker_threads | Int | 否 | 每个Instance中用于并发处理请求的线程数。 | 5 |
| rpc.max_queue_size | Int | 否 | 请求处理时队列的最大长度，队列满时新请求会被以450状态码丢弃。 | 64 |
| rpc.keepalive | Int | 否 | 请求的超时时间，单位为毫秒。 | 5000 |
| rpc.rate_limit | Int | 否 | 单实例请求限流的QPS值，单实例QPS超出该值后的请求会被返回429丢弃。 | 0 |
| release | Bool | 否 | 若为true，则要创建一个灰度发布服务。 | false |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| object |
返回结果。 |
||
| RequestId | string |
请求ID。 |
40325405-579C-4D82**** |
| ServiceId | string |
新创建服务的服务ID。 |
eas-m-aaxxxddf |
| ServiceName | string |
新创建服务的服务名字。 |
yourname |
| Status | string |
新服务的当前状态。 |
Creating |
| Region | string |
新创建服务所属的区域ID。 |
cn-shanghai |
| InternetEndpoint | string |
新创建服务的公网Endpoint。 |
http://pai-eas.vpc.cn-shanghai.**** |
| IntranetEndpoint | string |
新创建服务的内网Endpoint。 |
http://pai-eas.cn-shanghai.**** |
示例
正常返回示例
JSON格式
{
"RequestId": "40325405-579C-4D82****",
"ServiceId": "eas-m-aaxxxddf",
"ServiceName": "yourname",
"Status": "Creating",
"Region": "cn-shanghai",
"InternetEndpoint": "http://pai-eas.vpc.cn-shanghai.****",
"IntranetEndpoint": "http://pai-eas.cn-shanghai.****"
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||
|---|---|---|---|---|---|---|
| 2023-09-01 | OpenAPI 入参发生变更 | 看变更集 | ||||
|
||||||
| 2023-01-04 | OpenAPI 入参发生变更 | 看变更集 | ||||
|
内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家
阿里云企业补贴进行中： 马上申请
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利:同意关联，立享优惠
转转请注明出处：https://www.yunxiaoer.com/161878.html
