华为云用户手册

请求示例 创建导入（从OBS导入）任务 { "import_type" : "dir", "import_path" : "s3://test-obs/daoLu_images/animals/", "included_labels" : [ ], "import_annotations" : false, "difficult_only" : false } 创建导入（从Manifest导入）任务 { "import_type" : "manifest", "import_path" : "s3://test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/V002.manifest", "included_labels" : [ "rabbits", "bees", "Rabbits", "Bees" ], "import_annotations" : true, "difficult_only" : false }

URI GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/metrics 表1 路径参数 参数 是否必选 参数类型 描述 dataset_id 是 String 数据集ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 workforce_task_id 是 String 团队标注任务ID。

响应示例 状态码： 200 OK { "sample_stats" : { "xxx@xxx.com" : { "un_annotation" : 51, "rejected" : 0, "unreviewed" : 0, "accepted" : 0, "auto_annotation" : 0, "uncheck" : 0 } } }

响应示例 状态码： 200 OK { "total_stats" : { "sampling_rate" : 1.0, "sampling_num" : 3, "pass_rate" : 0.0, "score" : "E", "total_score" : 0, "total_sample_count" : 3, "sampled_sample_count" : 3, "unchecked_sample_count" : 3, "checked_sample_count" : 0, "accepted_sample_count" : 0, "rejected_sample_count" : 0 } }

URI GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/acceptance/report 表1 路径参数 参数 是否必选 参数类型 描述 dataset_id 是 String 数据集ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 workforce_task_id 是 String 团队标注任务ID。 表2 Query参数 参数 是否必选 参数类型 描述 checking_task_id 是 String 正在检查的任务ID。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 checking_stats CheckTaskStats object 实时验收统计信息。 total_stats CheckTaskStats object 历史汇总后的统计信息。 表4 CheckTaskStats 参数 参数类型 描述 accepted_sample_count Integer 通过的样本数目。 checked_sample_count Integer 已验收的样本数目。 pass_rate Double 样本的通过率。 rejected_sample_count Integer 驳回的样本数目。 sampled_sample_count Integer 抽样的样本数目。 sampling_num Integer 验收任务的抽样数目。 sampling_rate Double 验收任务的抽样比例。 score String 验收评分。 task_id String 验收任务ID。 total_sample_count Integer 总的样本数目。 total_score Long 验收总分。 unchecked_sample_count Integer 未验收的样本数目。

响应示例 状态码：200 OK { "enable_app_auth" : true, "app_auth_api" : { "api_id" : "string", "authed_apps" : [ { "app_codes" : [ "1f5f6cb703864cc580d1ba2cdfd77a271a74eee8e5a242e8b5adc009f77a8b2a" ], "app_id" : "54d9104db9e7418f9138980da63a857f", "app_key" : "151f1f4dfb20445b97326bde3db0c515", "app_name" : "app_for_9332aab245ea4d56871e75d6966aa274", "app_remark" : "app for user op_svc_modelarts_container0", "app_secret" : "0080fa74e6214d0c8d1b2cb01d9d7708", "app_type" : "APIG", "bounded_api_count" : 0, "created_at" : 1574946998167, "project_id" : "string", "updated_at" : 1574946998167, "user_id" : "9332aab245ea4d56871e75d6966aa274" } ] } }

URI GET /v1/{project_id}/services/{service_id}/api-auths 表1 路径参数 参数 是否必选 参数类型 描述 service_id 是 String 服务ID project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 表2 Query参数 参数 是否必选 参数类型 描述 workspace_id 否 String 工作空间ID。获取方法请参见查询工作空间列表。未创建工作空间时默认值为“0”，存在创建并使用的工作空间，以实际取值为准。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 enable_app_auth Boolean APP是否已授权。 app_auth_api AppAuthApiAuthInfo object API已授权的APP的基本信息。 表5 AppAuthApiAuthInfo 参数 参数类型 描述 api_id String API编号。 authed_apps Array of ApigAppDetailInfo objects API已授权的APP的基本信息。 表6 ApigAppDetailInfo 参数 参数类型 描述 app_codes Array of strings APP Code列表，当APP类型为APIC时，此参数为空。 app_id String APP编号。 app_key String APP的key。 app_name String APP名称。 app_remark String APP描述，默认为空。不超过200个字符。 app_secret String APP密钥。 app_type String APP类型。枚举值如下： APIC：该APP注册在roma connect网关上 APIG：该APP注册在共享API网关上 DEDICATE_APIG：该APP注册在专享API网关上 bounded_api_count Integer APP绑定API数量。 created_at Long APP创建时间。 project_id String 项目ID。 updated_at Long APP更新时间。 user_id String APP创建用户ID。 状态码：401 表7 响应Body参数 参数 参数类型 描述 error_code String ModelArts错误码。 error_msg String 具体错误信息。 状态码：403 表8 响应Body参数 参数 参数类型 描述 error_code String ModelArts错误码。 error_msg String 具体错误信息。 状态码：404 表9 响应Body参数 参数 参数类型 描述 error_code String ModelArts错误码。 error_msg String 具体错误信息。

URI GET /v2/{project_id}/processor-tasks/items 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 分页列表的起始页，默认为0。 limit 否 Integer 指定每一页返回的最大条目数，取值范围[1,1000]，默认为1000。

响应示例 状态码： 200 OK { "total" : 4, "items" : [ { "template_id" : "sys_data_cleaning", "label_zh" : "label_zh to translate", "label_en" : "data cleaning" }, { "template_id" : "sys_data_validation", "label_zh" : "label_zh to translate", "label_en" : "data validation" }, { "template_id" : "sys_data_selection", "label_zh" : "label_zh to translate", "label_en" : "data selection" }, { "template_id" : "sys_data_augmentation", "label_zh" : "label_zh to translate", "label_en" : "data augmentation" } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 items Array of ProcessorTaskItem objects 算法类别的列表。 total Integer 总数。 表4 ProcessorTaskItem 参数 参数类型 描述 label_en String 算法类别的英文名称。 label_zh String 算法类别名称。 template_id String 算法类别的ID。

URI GET /v2/{project_id}/datasets/{dataset_id}/export-tasks 表1 路径参数 参数 是否必选 参数类型 描述 dataset_id 是 String 数据集ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 表2 Query参数 参数 是否必选 参数类型 描述 export_type 否 Integer 导出类型，不传则默认查询所有类型的导出任务。可选值如下： 0：已标注 1：未标注 2：全部 3：条件筛选 limit 否 Integer 指定每一页返回的最大条目数，取值范围[1,100]，默认为10。 offset 否 Integer 分页列表的起始页，默认为0。

响应示例 状态码： 200 OK { "total_count" : 2, "export_tasks" : [ { "task_id" : "rF9NNoB56k5rtYKg2Y7", "path" : "/test-obs/classify/input/", "export_type" : 3, "version_format" : "Default", "export_format" : 2, "export_params" : { "sample_state" : "", "export_dest" : "NEW_DATASET", "export_new_dataset_name" : "dataset-export-test", "export_new_dataset_work_path" : "/test-obs/classify/output/", "clear_hard_property" : true, "train_sample_ratio" : 1.0, "ratio_sample_usage" : false }, "status" : "SUC CES SED", "progress" : 100.0, "total_sample_count" : 20, "finished_sample_count" : 20, "create_time" : 1606103820120, "update_time" : 1606103824823 }, { "task_id" : "TZMuy7OKbClkGCAc3gb", "path" : "/test-obs/daoChu/", "export_type" : 3, "version_format" : "Default", "export_format" : 2, "export_params" : { "sample_state" : "", "export_dest" : "DIR", "clear_hard_property" : true, "clear_difficult" : false, "train_sample_ratio" : 1.0, "ratio_sample_usage" : false }, "status" : "SUCCESSED", "progress" : 100.0, "total_sample_count" : 20, "finished_sample_count" : 20, "create_time" : 1606103424662, "update_time" : 1606103497519 } ] }

URI GET /v2/{project_id}/datasets/{resource_id}/export-tasks/{task_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 resource_id 是 String 资源ID，当前支持传数据集ID。 task_id 是 String 导出任务ID。

响应示例 状态码： 200 OK { "task_id" : "TZMuy7OKbClkGCAc3gb", "path" : "/test-obs/daoChu/", "export_type" : 3, "version_format" : "Default", "export_format" : 2, "export_params" : { "sample_state" : "", "export_dest" : "DIR", "clear_hard_property" : true, "train_sample_ratio" : 1.0, "ratio_sample_usage" : false }, "status" : "RUNNING", "progress" : 0.0, "create_time" : 1606103424662, "update_time" : 1606103494124 }

URI GET /v2/{project_id}/datasets/{dataset_id}/data-annotations/stats 表1 路径参数 参数 是否必选 参数类型 描述 dataset_id 是 String 数据集ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 表2 Query参数 参数 是否必选 参数类型 描述 email 否 String 标注团队成员邮箱。 locale 否 String 语言。可选值如下： zh-cn：中文 en-us：英文（默认值） sample_state 否 String 查询指定样本状态下的统计信息。可选样本状态如下： __ALL__：已标注 __NONE__：未标注 __UNCHECK__：待验收 __ACCEPTED__：验收通过 __REJECTED__：已驳回 __UNREVIEWED__：待审核 __REVIEWED__：已审核 __WORKFORCE_SAMPLED__：已采样 __WORKFORCE_SAMPLED_UNCHECK__：采样待验收 __WORKFORCE_SAMPLED_CHECKED__：采样已验收 __WORKFORCE_SAMPLED_ACCEPTED__：采样已通过 __WORKFORCE_SAMPLED_REJECTED__：采样已驳回 __AUTO_ANNOTATION__：待确认

响应示例 状态码： 200 OK { "label_stats" : [ { "name" : "Bees", "type" : 1, "property" : { "@modelarts:color" : "#3399ff" }, "count" : 8, "sample_count" : 5 } ], "sample_stats" : { "un_annotation" : 309, "all" : 317, "total" : 317, "deleted" : 0, "manual_annotation" : 8, "auto_annotation" : 0, "lefted" : 317 }, "key_sample_stats" : { "total" : 317, "non_key_sample" : 315, "key_sample" : 2 }, "metadata_stats" : { }, "data_spliting_enable" : false }

响应示例 状态码： 200 OK { "metrics" : { "un_annotation" : { "1606233612612" : 16, "1606320012681" : 16 }, "failed_user" : { }, "total" : { "1606233612612" : 16, "1606320012681" : 16 }, "queuing" : { }, "success" : { }, "unfinished" : { }, "manual_annotation" : { "1606233612612" : 0, "1606320012681" : 0 }, "failed" : { }, "failed_system" : { } } }

URI GET /v2/{project_id}/datasets/{dataset_id}/metrics 表1 路径参数 参数 是否必选 参数类型 描述 dataset_id 是 String 数据集ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 表2 Query参数 参数 是否必选 参数类型 描述 end_time 是 Long 监控信息的截止时间。 start_time 是 Long 监控信息的起始时间。 workforce_task_id 否 String 团队标注任务ID。

URI GET /v2/{project_id}/authorizations 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 表2 Query参数 参数 是否必选 参数类型 描述 sort_by 否 String 指定排序字段。枚举值如下： user_name： IAM 用户名称 create_time：创建时间 order 否 String 排序方式。枚举值如下： asc：递增排序 desc：递减排序 limit 否 Integer 指定每一页返回的最大条目数，默认为1000。 取值范围[1，1000]。 offset 否 Integer 分页列表的起始页，默认为0。

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 total_count Number 授权信息总数。 auth Array of AuthorizationResponse objects 授权信息列表。 表4 AuthorizationResponse 参数 参数类型 描述 user_id String 用户ID，获取方法请参见获取用户ID和名称。 当user_id为all时，表示对所有IAM子用户进行授权，如果已有部分用户已授权，则更新授权。 仅当授权类型为委托时，需要该字段。 type String 授权类型。推荐使用委托方式。 可选值： agency：委托 credential：访问密钥（AK/SK） content String 授权内容。 当授权类型是委托，该字段为委托名称。 当授权类型是访问密钥，该字段为访问密钥ID（AK）。 secret_key String 秘密访问密钥（SK）。仅当授权类型为访问密钥时，需要该字段。 user_name String 用户名，当user_id为all-users时，显示为所有用户。 create_time Long 创建时间戳。

响应示例 状态码：200 OK { "total_count" : 1, "auth" : [ { "user_id" : "****d80fb058844ae8b82aa66d9fe****", "user_name" : "iam-user01", "type" : "agency", "content" : "modelarts_agency", "create_time" : 15657747821288 } ] }

响应示例 状态码：200 OK { "apis" : [ { "api_id" : "528087f0cfec48f7959db7834ee441cb", "api_method" : "ANY", "api_name" : "testNoneAuth", "api_remark" : "string", "auth_type" : "APP", "predict_url" : "https://3565150c2e5c45d0989be40350dd80ed.apig.xxxxxx.com/test", "service_id" : "bb149aac-5ff4-497c-bb73-acb751e20a11", "service_name" : "service-hutest", "support_app_code" : false } ], "count" : 1, "total_count" : 1 }

URI GET /v1/{project_id}/services/{service_id}/app-auth-apis 表1 路径参数 参数 是否必选 参数类型 描述 service_id 是 String 服务ID project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 表2 Query参数 参数 是否必选 参数类型 描述 workspace_id 否 String 工作空间ID。获取方法请参见查询工作空间列表。未创建工作空间时默认值为“0”，存在创建并使用的工作空间，以实际取值为准。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 apis Array of AuthTypeApiBasicInfo objects API认证信息列表。 count Integer 查询数据个数。 total_count Integer 数据总量。 表5 AuthTypeApiBasicInfo 参数 参数类型 描述 api_id String API编号。 api_method String 请求方式包含GET、POST、PUT、DELETE、HEAD、PATCH、OPTIONS、ANY，固定返回ANY。 api_name String API名称。 api_remark String API描述。字符长度不超过255。 auth_type String API的认证方式。枚举值如下： NONE：无认证 APP：APP认证 IAM：IAM认证 predict_url String 预测地址。 service_id String 服务编号。 service_name String 服务名称。 support_app_code Boolean 是否支持APP CODE。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 api AuthTypeApiBasicInfo object API认证详情。 表5 AuthTypeApiBasicInfo 参数 参数类型 描述 api_id String API编号。 api_method String 请求方式包含GET、POST、PUT、DELETE、HEAD、PATCH、OPTIONS、ANY，固定返回ANY。 api_name String API名称。 api_remark String API描述。字符长度不超过255。 auth_type String API的认证方式。枚举值如下： NONE：无认证 APP：APP认证 IAM：IAM认证 predict_url String 预测地址。 service_id String 服务编号。 service_name String 服务名称。 support_app_code Boolean 是否支持APP CODE。 状态码：401 表6 响应Body参数 参数 参数类型 描述 error_code String ModelArts错误码。 error_msg String 具体错误信息。 状态码：403 表7 响应Body参数 参数 参数类型 描述 error_code String ModelArts错误码。 error_msg String 具体错误信息。 状态码：404 表8 响应Body参数 参数 参数类型 描述 error_code String ModelArts错误码。 error_msg String 具体错误信息。

URI GET /v1/{project_id}/app-auth/{service_id}/apis/{api_id} 表1 路径参数 参数 是否必选 参数类型 描述 service_id 是 String 服务编号，可通过查询服务列表获取。 api_id 是 String APP编号。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 表2 Query参数 参数 是否必选 参数类型 描述 workspace_id 否 String 工作空间ID。获取方法请参见查询工作空间列表。未创建工作空间时默认值为“0”，存在创建并使用的工作空间，以实际取值为准。

响应示例 状态码：200 OK { "api" : { "api_id" : "7e0d272df0e94297b7d4046bada3f158", "api_name" : "infer_ae20fc9fb37c48c28ebc3f3a638c9f48", "api_method" : "ANY", "predict_url" : "https://b86b2d069324491fbd66940e4533b45c.apig.xxxxxx.com/v1/infers/ae20fc9f-b37c-48c2-8ebc-3f3a638c9f48", "support_app_code" : true, "service_id" : "ae20fc9f-b37c-48c2-8ebc-3f3a638c9f48", "service_name" : "service-3c02", "auth_type" : "APP", "api_remark" : "test" } }

请求示例 创建导出（导出到OBS）任务 { "path" : "/test-obs/daoChu/", "export_type" : 3, "export_params" : { "sample_state" : "", "export_dest" : "DIR" } } 创建导出（导出新数据集）任务 { "path" : "/test-obs/classify/input/", "export_type" : 3, "export_params" : { "sample_state" : "", "export_dest" : "NEW_DATASET", "export_new_dataset_name" : "dataset-export-test", "export_new_dataset_work_path" : "/test-obs/classify/output/" } }